WP Agent Bridgeは、ChatGPT・Claude・CodexなどのAIから、WordPressの記事・固定ページ・画像・設定などを操作するためのWordPressプラグインです。「この記事の表を直して」「画像を登録してアイキャッチに設定して」といった依頼を、利用者自身のGitHubを通じてWordPressへ届けます。
運営者の中継サーバーを経由しない、利用者所有の実行経路です。
- 中継サーバーなし:経路は「AI → 利用者自身の非公開GitHubリポジトリ → 利用者自身のWordPress」です。記事本文や操作要求を運営者のサーバーへ送る通常経路はありません。
- Bridge独自の回数制限なし:実行回数の上限や、操作ごとの従量課金はありません。ただし、通り道になるGitHub・WordPressサーバー・AIの上限はそのまま効きます(GitHubなどによる制限)。
- 自分のGitHubを実行基盤に使う:操作要求と結果は、自分で管理する非公開リポジトリに保存されます。接続と通知には、サイト専用のGitHub Appを使います。
ダウンロードと導入
WP Agent Bridge 1.1.44
WordPress用プラグインZIP
WP Agent Bridge Helper 0.3.1
AI側に入れる補助プラグイン(任意・ChatGPT / Codex / Claude共通)
配布情報を確認しています。確認できない場合も、上の1.1.44をダウンロードできます。
- 上のボタンからプラグインZIPを保存します。
- WordPressの「プラグイン」からZIPをアップロードし、有効化します。
- 「ツール → WP Agent Bridge」の案内に従い、自分のGitHubに専用の非公開リポジトリを用意します。
- 「Connect GitHub」からサイト専用のGitHub Appを作成し、そのリポジトリだけに接続します。
- 使うAIから、そのリポジトリを読み書きできるようにします(ChatGPT / CodexはGitHubアプリ、Claudeは自分のGitHubログイン。下の補助プラグインも参照)。
- AIに対象のURLと、行いたい変更を伝えます。
動作には、WordPress 6.9以上・PHP 7.4以上・OpenSSLと、GitHubのWebhookが届くHTTPS公開サイトが必要です。詳しい手順は公式READMEにあります。
AI側の補助プラグイン(WP Agent Bridge Helper・任意)
Bridge本体はHelperなしでも動きます。HelperはAI側に入れる補助で、1つのZIPがChatGPTデスクトップ / Codex、Claude Code、claude.ai、Coworkのどれにも入ります。認証情報は含まず、GitHubやWordPressの権限を増やすこともありません。
- 操作の約束事:要求の書き方、結果の確認方法、変更前の照合、画像の扱いをAIに持たせます。
- 誤判定の防止:会話の途中でGitHubのツールが見えなくなっても、すぐに「WP Agent Bridgeは使えない」と判断せず、1回探してから判定します。
- 転送スクリプト(wpab.py):Claude CodeやCodex CLIなどターミナルで動くAI向けに、要求の送信と結果の確認を決まった手順で行います。GitHubのAPI書き込みが拒否される環境では、自動で
git pushに切り替えます。
ChatGPTデスクトップ / Codex
codex plugin marketplace add takka-d/wp-agent-bridge --ref mainを実行してChatGPT / Codexを再読み込みし、PluginsからWP Agent Bridge Helperを入れます。GitHubへの接続を求められたら、WP Agent Bridgeで使うGitHubアカウントを接続します。
ZIPから手動で入れる場合:Helper ZIPを展開して~/.codex/plugins/wp-agent-bridge-helper/(Windowsは%USERPROFILE%\.codex\plugins\wp-agent-bridge-helper\)に置き、フォルダ直下にplugin.json・.app.json・.codex-plugin・skillsが来るようにします。続けて~/.agents/plugins/marketplace.json(Windowsは%USERPROFILE%\.agents\plugins\marketplace.json)を次の内容で作成します。すでにある場合は上書きせず、wp-agent-bridge-helperのエントリをplugins配列に追加します。
{
"name": "personal-plugins",
"interface": {
"displayName": "Personal Plugins"
},
"plugins": [
{
"name": "wp-agent-bridge-helper",
"source": {
"source": "local",
"path": "./.codex/plugins/wp-agent-bridge-helper"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Developer Tools"
}
]
}
最後にChatGPTデスクトップアプリまたはCodexを完全に再起動し、PluginsのPersonal Pluginsからインストールします。更新時は同じフォルダのファイルを入れ替えて再起動します。仕組みはOpenAI公式ドキュメントも参照してください。
Claude Code
claude plugin marketplace add takka-d/wp-agent-bridge claude plugin install wp-agent-bridge-helper@wp-agent-bridge
セッション内では/plugin marketplace add takka-d/wp-agent-bridgeと/plugin install wp-agent-bridge-helper@wp-agent-bridgeでも同じです。GitHubへの書き込みには、自分のアカウントでログインしたgh(GitHub CLI、gh auth login)を使います。トークンを設定ファイルに書く必要はありません。更新はclaude plugin update wp-agent-bridge-helper@wp-agent-bridgeです。
claude.ai / Cowork
「Customize > Plugins > Add」で、マーケットプレイスとしてhttps://github.com/takka-d/wp-agent-bridgeを追加するか、Helper ZIPをそのままアップロードします。追加したプラグインは、次に起動したClaude Codeにも同期されます。GitHubへの書き込み経路は、使う場所で変わります。
- Coworkや、デスクトップアプリと連携したチャット:連携したPCにログイン済みの
ghを使います。 - Claude Code on the web:セッションに非公開リポジトリを書き込み権限付きで接続します。読み取りは
gh api、書き込みはgit pushです。 - PCと連携していないclaude.aiのチャットだけ:書き込み経路がないため、WordPressの操作は実行できません。
何ができる?
記事・固定ページの編集
記事の検索、下書き作成、タイトルや公開状態の変更、本文の部分編集、表の修正など。本文の変更は、変更案と現在の内容を照合してから適用します。
画像・メディアの管理
画像の登録、アイキャッチやサイトアイコンの設定など。元の画像を変えずに分割して送り、WordPress側でサイズとSHA-256(内容の照合値)を確かめてから登録します。
テーマ・サイト設定の操作
対応する設定、メニュー、プラグイン・テーマの管理、テーマファイルの調査・編集など。変更内容に応じた確認や保護が入ります。
継続的なファイル編集
HTML・JavaScript・CSSなどを作業領域に保持し、必要な部分だけを読み、検索・差分編集できます。保存時点への復元もできます。
使える操作は、インストールした版が生成する機能一覧で決まります。すべてのWordPressプラグインや独自機能を、同じ手順で操作できるわけではありません。
仕組み:GitHubを通じてWordPressへ依頼する
GitHubアプリ、または自分のGitHubログインで書き込み
操作要求・結果・必要な作業データを保存
サイト専用GitHub App
リポジトリの変更を通知
Webhook→
AIがWordPressのデータベースを直接書き換えるのではなく、WordPressに入れたBridgeが要求を受け取り、対応する処理を実行します。GitHub Appは通知とアクセス権のための仕組みで、WordPressの処理を実行するサーバーではありません。
依頼するときの例
「このURLの記事を確認して、料金表の該当行だけを修正して。変更後も下書きのままにして」
「添付画像をメディアに登録し、指定した記事のアイキャッチに設定して」
「この固定ページの説明文を直して。まず変更箇所を確認してから反映して」
記事名だけでは同名の候補があり得るため、URLを添えると対象を特定しやすくなります。URL・タイトル・投稿種別などが矛盾する場合や、タイトルが一意に決まらない場合、Bridgeは処理を拒否します。
データの扱いと変更時の保護
- データの通り道:操作に必要な情報は、使うAI・GitHub・利用者のWordPressで扱われます。非公開リポジトリを使っても、外部サービスを使わないローカル完結の仕組みにはなりません。
- 接続先の確認:Bridgeは通知の署名と、設定したリポジトリ・GitHub App・実行用ブランチを照合します。
- 変更前の照合:本文の差分編集などでは、変更案と元データのハッシュ(内容を照合する値)を確認し、別の変更が入っていれば適用を拒否します。保護の内容は操作ごとに異なります。
- 重複実行の防止:同じ要求を二重に実行しない仕組みがあります。結果の取得が遅れても、同じ変更を新しい要求として送り直さないでください。
- 保存と表示は別:書き込みの成功やハッシュの一致は、ページの見た目が正しいことまでは示しません。公開前に実際の表示も確認します。
操作要求や結果には記事内容が含まれることがあり、Gitの履歴にも残ります。非公開リポジトリの閲覧権限も、サイトの管理対象として扱ってください。
GitHubなどによる制限
WP Agent Bridgeに独自の回数制限はありませんが、通り道になるGitHub・WordPressサーバー・AIの上限はそのまま効きます。数値は2026年11月時点の各公式ドキュメントと、このサイト(takka-note.com)での実測です。
| 項目 | 上限・目安 | 実際の影響 |
|---|---|---|
| 往復時間 | GitHubへの保存 → Webhook → WordPressで実行 → 結果をGitHubへ保存 → AIが読む | このサイトでは、操作要求の作成から実行までの中央値が約7秒です。AI側の待機や承認を含めると、1操作に数十秒以上かかることもあります。 |
| API回数 | 1時間5,000リクエスト(個人のトークン・GitHub Appとも基本値) | 通常の記事編集では届きにくい上限です。同じアカウントで他のツールも使うと、その分も数えられます。 |
| 書き込み頻度 | コンテンツを作るリクエストは1分80件・1時間500件まで。pushは1リポジトリにつき1分6回程度が推奨 | WordPress側は操作1件ごとに結果をGitHubへコミットします。数百件の操作を続けて送ると、一時的に拒否されて待ちが発生します。 |
| Webhook | 10秒以内に応答しないと失敗扱い。GitHubは自動では再送しない | Bridgeは次にリポジトリが更新されたとき、未処理の要求を拾い直します(1回20件まで)。24時間を過ぎた要求は実行されません。 |
| 1回の量 | 1回のpushで処理する要求は20件まで。要求1件は2 MiBまで(Bridgeの上限) | 大量の変更は分けて送ります。本文の大きな書き換えは、全置換より部分的な差分編集が向いています。 |
| 画像・ファイル | 1ファイル6 MiBまで(Bridgeの上限)。AIに渡した画像は8 KiBずつ分割し、1片ずつ要求として送る | 1 MiBで約128件になります。このサイトでは、約1.2 MB(150件)の画像の登録に約12分かかりました。WebPなどで小さくしてから渡すのが確実です。 |
| リポジトリ容量 | 結果ファイルと処理済みの要求は自動では削除されない。GitHubの推奨は1フォルダ3,000件以内・リポジトリ10 GB以内 | このサイトでは約2か月で結果ファイルが約1万700件、リポジトリが約110 MBになりました。履歴には記事内容も残ります。 |
| サーバー | HTTPSで公開され、GitHubのWebhookがREST APIへ届くこと。PHPの実行時間・メモリ、WAF、外部通信の制限もそのまま効く | ローカル環境やBasic認証の内側では受信できません。リビジョンの多い大きな記事は保存に時間がかかることがあり、表示時に本文を変換するプラグインの影響も受けます。 |
| AI側 | ChatGPT / CodexはGitHubアプリ、Claudeは書き込み経路(Claude Code・連携PCのgh・Claude Code on the web)が必要 |
GitHubアプリでは要求1件ごとにファイル作成の呼び出しが1回要るため、分割アップロードは呼び出しが多くなります。GitHub公式のリモートMCPサーバーは、Claude DesktopのカスタムコネクタからのOAuth認証に未対応と案内しています。AIの利用上限や承認表示も、それぞれの条件に従います。 |
| GitHub障害 | GitHubが止まっている間は操作できない | WordPressの管理画面は通常どおり使えます。 |
Bridge側でも、1回で読み取る量に上限があります(本文の範囲読み取りは1,000行・256 KiB、記事候補の検索は20件、リビジョン一覧は50件など)。長い記事は範囲を分けて読みます。
出典:GitHub Docs「Rate limits for the REST API」「Handling failed webhook deliveries」「Repository limits」、github/github-mcp-server「Install GitHub MCP Server in Claude Applications」
よくある疑問
「結果ファイルが未生成」と表示されたら、操作は失敗した?
結果を取得できなかっただけでは、失敗とは限りません。WordPressが処理して結果をGitHubへ保存する前に確認すると、結果はまだ見つかりません。
| 確認できた状態 | 意味と確認方法 |
|---|---|
| 結果をまだ取得できない | 実行結果は未確認です。少し時間を空け、同じ操作の識別番号に対応する結果を確認します。 |
| GitHubへのアクセスや結果取得でエラー | 接続権限や取得方法の問題です。これだけではWordPress側の操作が失敗したとは判断できません。 |
| WordPressの結果に操作エラーがある | 実行失敗です。対象の不一致、変更前の内容との不一致など、返された理由を確認します。 |
| 一括処理の結果が一部だけ | 全件完了とは扱いません。成功した項目を残し、実行エラー・結果の省略・未着手を確認して、必要な項目だけを続けます。 |
読めない場合は「未確認」として扱い、まず最初に送った要求の結果を確認してください。同じ変更を新しい要求として送り直すと、別の操作として実行されることがあります。
途中で「WP Agent Bridgeを使えない」と言われたら?
ChatGPTでは、GitHubアプリを接続していても、会話の途中でGitHubのツールがAIから見えなくなることがあります。BridgeやWordPressの切断とは別の問題で、@GitHubやアプリ選択からGitHubを選び直すと戻ります。Claudeでは、その会話にGitHubへの書き込み経路があるかで決まります(GitHubなどによる制限の「AI側」)。
配布・利用について
WP Agent Bridgeのダウンロード・インストール・利用は無料です。外部サービスの利用条件や費用は、それぞれのサービスに従います。ソースコードは公開していますが、再配布に制限のあるライセンスです。利用条件は公式ライセンスを確認してください。
コメント