ものづくりのブログ

うちのネコを題材にしたものづくりができたらいいなと思っていろいろ奮闘してます。

blogsync の使い方のメモ

blogsync とは

blogsync は、はてなブログの記事をローカルの Markdown ファイルとして同期できる CLI ツールです。手元のエディタや Claude Code で記事を編集し、コマンド一つではてなブログに反映できます。

この記事では、blogsync を使うために必要な設定ファイルの書き方をまとめます。

設定ファイルの置き場所

設定ファイルは次の2か所に置けます。

種類 パス 用途
グローバル設定 ~/.config/blogsync/config.yaml どのディレクトリからでも使う共通設定
ローカル設定 ./blogsync.yaml 記事管理用のフォルダごとの設定

記事を Git で管理する場合は、リポジトリ直下に blogsync.yaml を置くローカル設定が便利です。

基本の書き方

もっともシンプルな設定は次のとおりです。

example.hatenablog.com:
  username: your-hatena-id
  password: YOUR_API_KEY
default:
  local_root: ./entries

各項目の意味は以下のとおりです。

  • example.hatenablog.com:ブログのドメイン(ブログID)。独自ドメインの場合は「はてなブログ側のドメイン」を書きます
  • username:はてなID
  • password:AtomPubのAPIキー(はてなのログインパスワードではありません)
  • default:すべてのブログに共通で適用される設定

APIキーの確認方法

APIキーは、はてなブログの管理画面から確認できます。

  1. 「設定」を開く
  2. 「詳細設定」タブを開く
  3. 「AtomPub」の欄に表示されている「APIキー」をコピーする

API キーは他人に知られるとブログを編集されてしまうので、公開リポジトリにコミットしないよう注意しましょう。

設定できる主な項目

項目 説明
local_root 記事を保存するフォルダのルート。通常は local_root/ブログID/ の下に記事が保存される
omit_domain true にすると、保存先のパスにブログIDを含めず local_root の直下に記事を保存する
owner 編集するブログのオーナーが自分以外の場合(共同編集のブログなど)に、オーナーのはてなIDを指定する

応用例

保存先からドメイン名のフォルダを省く

ブログを1つしか管理しない場合は、omit_domain を使うとフォルダ構成がすっきりします。

example.hatenablog.com:
  username: your-hatena-id
  password: YOUR_API_KEY
  omit_domain: true
default:
  local_root: ./entries

複数のブログを管理する

ドメインごとにブロックを分けて書くだけで、複数のブログを扱えます。

blog-a.hatenablog.com:
  username: your-hatena-id
  password: YOUR_API_KEY
blog-b.hatenadiary.jp:
  username: your-hatena-id
  password: YOUR_API_KEY
default:
  local_root: ~/blog

他の人がオーナーのブログを編集する

共同編集しているブログなどでは owner を指定します。

team-blog.hatenablog.com:
  username: your-hatena-id
  password: YOUR_API_KEY
  owner: owner-hatena-id
default:
  local_root: ./entries

設定後に使うコマンド

設定ができたら、次のコマンドで記事を操作できます。

# 既存の記事をダウンロード
blogsync pull example.hatenablog.com

# 編集した記事を反映
blogsync push entries/example.hatenablog.com/entry/2026/10/09/123456.md

# 新しい記事を下書きとして投稿
blogsync post --draft --title="記事タイトル" example.hatenablog.com < draft.md

blogsyncのインストール

blogsyncはいくつかの方法でインストールできます。

Homebrewを使う(macOS向け・おすすめ)

brew install Songmu/tap/blogsync

Goを使う

Goがインストールされている環境なら、次のコマンドでもインストールできます。

go install github.com/x-motemen/blogsync@latest

この方法では、バイナリが ~/go/bin に配置されます。PATHが通っていない場合は、~/.zshrc(bashなら ~/.bashrc)に次の行を追加して反映させましょう。

export PATH="$HOME/go/bin:$PATH"
source ~/.zshrc

バイナリを直接ダウンロードする

GitHubの x-motemen/blogsync のReleasesページから、使っている環境に合ったファイルをダウンロードする方法もあります。

環境 選ぶファイル
Apple Silicon(M1以降)のMac darwin_arm64
Intel Mac darwin_amd64
Linux(一般的なPC) linux_amd64

展開した blogsync を /usr/local/bin など、PATHの通ったフォルダに置けば使えるようになります。

インストールできたか確認する

which blogsync

パスが表示されればインストール完了です。blogsync not found と表示される場合は、インストールに失敗しているか、PATHが通っていない可能性があります。

blogsync --help

を実行すると、使えるコマンドの一覧が表示されます。

まとめ

  • 設定ファイルはグローバル(~/.config/blogsync/config.yaml)かローカル(./blogsync.yaml)に置く
  • 最低限必要なのは、ドメイン・はてなID・APIキー・local_root
  • APIキーは公開しないよう注意する

設定さえ済めば、記事をローカルファイルとして自由に編集できるようになります。