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:はてなIDpassword:AtomPubのAPIキー(はてなのログインパスワードではありません)default:すべてのブログに共通で適用される設定
APIキーの確認方法
APIキーは、はてなブログの管理画面から確認できます。
- 「設定」を開く
- 「詳細設定」タブを開く
- 「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キーは公開しないよう注意する
設定さえ済めば、記事をローカルファイルとして自由に編集できるようになります。