Claude Code × OpenSEO セルフホスト導入完全ガイド
SEO業務をAIに任せたい、けれど SaaS の月額固定費は払いたくない。そんな中小企業や個人事業主にとって、Claude Code から OpenSEO を直接呼び出せる「セルフホスト構成」は、いま最も現実的な選択肢のひとつです。
株式会社Fyveは、社内のSEO業務を Claude Code 上に集約してきた立場から、この OpenSEO のセルフホスト構成を実際に組んで運用しています。本記事では、私たちが実際に詰まった点を含め、ゼロから動かせる状態にするまでの全手順を、AIに作業を任せる前提でまとめます。
「Semrush 級のSEOツールを、Cloudflare Workers の無料枠と従量課金 API だけで成立させる」という構成は、SEOにAIを取り入れる第一歩として非常に強力です。読み終えるころには、自社の Claude Code から OpenSEO の16個のツールを呼び出せる状態になっています。
OpenSEOとは何か — Semrush代替のオープンソースSEOツール
OpenSEO は、Semrush や Ahrefs のような有料SEOツールの主要機能を、オープンソースとして利用できるようにしたツール群です。検索順位の調査、競合分析、被リンクの確認、サイト監査といった「SEO担当者がやりたいことの大半」をカバーしています。
特徴的なのは、Claude Code から直接呼び出せる MCP サーバとスキルが、公式で7本提供されていることです。これにより、SEO担当者がコマンドを覚えてダッシュボードを開く必要がなく、Claude Code に普通の日本語で指示するだけでリサーチが回り始めます。
OpenSEOで「できること」一覧
公式に提供されている主要機能は次のとおりです。
- Keyword Research: キーワードの検索ボリューム・難易度・関連語の調査
- Keyword Clustering: キーワード群を検索意図ごとに自動グルーピング
- Rank Tracking: 自社サイト・競合サイトの検索順位を継続追跡
- Domain insights: ドメイン単位でのトラフィック・流入キーワードの把握
- Backlinks: 被リンクプロファイルの確認（別料金）
- Site Audits: 自社サイトの技術的SEO問題の検出
- AI brand visibility: ChatGPT や Perplexity といった生成AI内での自社ブランド露出度の測定
とくに最後の「AI brand visibility」は、検索流入が生成AIに置き換わりつつある現状を踏まえると、今後の数年で重要度が跳ね上がる項目です。私たちも、ここを継続観測できる体制を整えること自体に大きな意味があると判断しています。
DataForSEO APIを内部で叩く構造
OpenSEO の中身は、SEOデータプロバイダの代表格である DataForSEO の API を呼び出すアプリケーションです。Semrush 等が独自にクロールしたデータを売っているのに対し、OpenSEO は DataForSEO に従量課金で問い合わせ、結果を整形してユーザーに返します。
この構造のおかげで、SEOツールとしての固定費がほぼゼロで済みます。ダッシュボードを毎月触らない月は、ほぼ課金が発生しません。固定費を嫌う中小企業との相性が極めて良い設計です。
Claude Code向けにMCPサーバ + スキル7本を公式提供
OpenSEO は、Claude Code から直接利用するための MCP サーバを公式で配布しています。さらに、SEO作業を「リサーチ → クラスタリング → 競合分析 → 被リンク → コーチング」の流れで自然に進められるよう、スキルが7本セットになっています。
このスキルセットを入れるだけで、Claude Code が「SEOコーチ」「キーワードリサーチャー」「競合アナリスト」を兼ねた状態になります。SEO担当者を新たに採用する代わりに、月数千円の API 従量課金で済ませる、という発想です。
セルフホストとマネージド版の選択肢
OpenSEO は、本家がホスティングしてくれる「マネージド版」と、自社の Cloudflare アカウントで動かす「セルフホスト版」のどちらも選べます。本記事は後者、つまりセルフホストの導入方法を扱います。
私たちがセルフホストを選んだ理由は、コストの透明性と、将来的に同じ仕組みをクライアントの環境に展開する可能性を残しておきたかったからです。
導入を決めた背景 — Fyveが抱えていたSEO業務の課題
そもそも、なぜ既存の SEO ワークフローでは足りなかったのか。私たちが抱えていた課題を率直に書いておきます。
キーワード選定の自動化が止まっていた
従来は、人間がキーワードプランナーや Search Console を眺めて、勘と経験でテーマを決めていました。これは「SEO担当者の頭の中」が属人化することを意味し、担当が増えても品質がそろわない、という壁にぶつかります。
Claude Code 単体では、検索ボリュームの一次データを取得できません。だからこそ、ボリュームと難易度を返してくれる API レイヤが必要でした。
「自分が想像もしていない効果的KW」発見の壁
キーワードリサーチで一番難しいのは、「自分が知らないキーワード」を発見することです。人間の発想は自分の語彙に縛られるため、本当に取りやすい穴場キーワードほど発見されません。
OpenSEO の keyword-research スキルは、こちらが与えた種キーワードから関連語を網羅的に展開し、検索ボリュームと難易度を一覧化してくれます。これによって「想像していなかった効果的キーワード」が出てくる確率が一気に上がります。
競合分析がほぼ実施できていなかった
多くの中小企業は、競合分析を「やった方がいい」と分かっていながら、実際にはほぼ実施できていません。理由は単純で、調査が面倒で時間がかかるからです。OpenSEO の competitor-analysis / competitive-landscape スキルは、ドメインを指定するだけで「競合が獲得している流入キーワード」「自社にない記事テーマ」を抽出してくれます。
既存スキルでカバーできない領域
私たちは既に、Google Search Console を解析する独自スキルと、X のトレンドからキーワードを発見するスキルを運用していました。これらは「すでに自社が露出している領域」と「いま起きているトレンド」をカバーしますが、「ライバル全体の地図」「狙うべきキーワードの優先順位」までは見えません。OpenSEO はちょうどこの空白地帯を埋める存在でした。
構成の判断プロセス — Mac mini？Cloudflare Workers？マネージド？
導入を決めた後、まず迷ったのが「どこで動かすか」でした。選択肢は大きく3つです。
Mac mini Tunnel案のメリットとデメリット
私たちは社内に Mac mini を常時稼働させており、Cloudflare Tunnel 経由で外部公開する基盤も持っています。OpenSEO もここに置けば、追加コストはゼロでした。
ただしこの構成は、自社専用にしか使えません。将来クライアントに同じ仕組みを提案するときに、再現性のある手順として渡しにくいというデメリットがあります。
Cloudflare Workersセルフホストを選んだ理由
結果として Cloudflare Workers を選びました。決め手は次の3点です。
- 無料枠の範囲で個人利用は十分にまかなえる
- クライアントに展開するときに「同じデプロイボタンを押すだけ」で済む再現性
- サーバの面倒を見る必要がゼロで、長期運用の運用負荷が低い
Cloudflare Workers は、リクエスト課金型のサーバレス基盤です。1日10万リクエストまで無料という枠は、自分ひとりが SEO リサーチに使う用途では使い切れません。
DataForSEO アカウント Business vs Personal
DataForSEO の契約は、Business と Personal のどちらかを選ぶ必要があります。OpenSEO 公式は Business 推奨です。理由は API のクオリティが上がる項目があり、Backlinks 等を本格運用する際に Business でしか取れないオプションが存在するためです。
個人利用や試験運用であれば Personal で十分です。私たちは将来的に Backlinks まで扱う前提で Business を選びました。
Backlinks API 月100ドルコミットの罠と回避策
注意点として、DataForSEO の Backlinks API は別契約で、最低月100ドルのコミットメントが要求されます。これは Keyword や SERP の従量課金とは性質が異なります。
そのため、被リンク調査を毎月使う予定がないなら、Backlinks は契約せず必要なときだけスポット契約する運用にするのが現実解です。最初は Keyword / SERP / Domain 系だけで始めて十分です。
セットアップ手順1 — DataForSEO アカウント開設
まずは DataForSEO のアカウントを取得します。OpenSEO は DataForSEO の API キーを内部で使うため、ここがなければ何も動きません。
アカウント種別の選択（Business推奨）
公式サイトから登録に進むと、Business / Personal の選択画面に入ります。冒頭で触れたとおり、長期的に運用するなら Business を選びます。
オンボーディングの入力項目
会社名・利用目的・想定リクエスト数といったオンボーディング項目を順に埋めます。利用目的は「SEO自動化／自社プロダクト統合」のような汎用的な答えで通ります。
APIクレデンシャル取得
登録完了後、ダッシュボードからログイン情報（メール + パスワード）を Base64 エンコードしたAPIキーを取得します。OpenSEO 側の環境変数として後で使うので、画面に表示されている値をコピーして安全な場所に控えておきます。
トライアル1ドルクレジットの注意点
DataForSEO は新規アカウントに 1 ドル分の試用クレジットを付与します。OpenSEO の動作確認程度なら、このクレジットでも十分試せます。本番運用を始める前に、ダッシュボードからクレジットチャージしておくと安心です。
セットアップ手順2 — Cloudflare Workers へのデプロイ
DataForSEO の準備ができたら、OpenSEO 本体を Cloudflare Workers にデプロイします。公式リポジトリには「Deploy to Cloudflare」ボタンが用意されており、基本はこれを押すだけです。
Deploy to Cloudflare ボタンから一発デプロイ
GitHub の OpenSEO 公式リポジトリを開き、READMEの「Deploy to Cloudflare」ボタンを押すと、Cloudflare のアカウントに紐づいた状態で自分用のフォークが作成され、ビルドとデプロイが自動で進みます。
R2サブスクリプション必須の落とし穴（無料枠内）
デプロイ途中で、Cloudflare R2（オブジェクトストレージ）のサブスクリプションを要求されます。最初に出くわすと「課金が始まるのでは」と身構えますが、これは「サービスを使える状態にする」ための同意であり、無料枠の範囲で利用できます。
R2 は10GBまで無料、月間Class A操作100万回・Class B操作1000万回まで無料です。OpenSEO の利用程度では超えません。サブスクリプションを開始しないとデプロイが止まるため、ここで詰まらないようにします。
KV/D1/R2のリソース命名衝突問題と回避
もう1つの落とし穴が、Cloudflare 側のリソース命名衝突です。OpenSEO は KV（キーバリュー）、D1（SQLite）、R2（ストレージ）を使いますが、デフォルト名のままだと、同じ Cloudflare アカウントで他のプロジェクトと衝突します。
私たちは open-seo-oauth / open-seo-cache / open-seo-db / open-seo-storage のように、プロジェクト接頭辞を付けて衝突を避けました。最初から付けておけば、後から触る必要がなく安全です。
プライベートGitリポジトリで forkすべき理由
Deploy ボタンは Public でフォークを作りますが、私たちはこれをすぐ Private に切り替えました。理由は、後述する環境変数（特に API キー）を wrangler.jsonc の vars セクションに記述する場面で、公開リポジトリだとセキュリティリスクが残るためです。
セットアップ手順3 — Cloudflare Access 認証の設定
OpenSEO の Worker は、デプロイ直後だと「URLさえ知っていれば誰でも叩ける」状態です。当然、ここに API キーを通すのは危険なので、Cloudflare Access で認証ゲートをかけます。
Zero Trust 無料プランの有効化
Cloudflare ダッシュボードから Zero Trust を開き、無料プランを有効化します。50ユーザーまで無料という枠は、1社で使うには十分すぎる規模です。
Application 作成 + Policy 設定
Zero Trust > Access > Applications で、デプロイした OpenSEO の URL を保護対象として登録します。続けて Policy を作り、「許可するメールアドレス（自分のメール）」を指定します。
ここで指定したメール宛にワンタイムパスコードが届き、ブラウザでログインする流れになります。GitHub OAuth など他のID連携も後から追加可能です。
POLICY_AUD と TEAM_DOMAIN の取得
Worker 側で「Cloudflare Access から来たリクエストかどうか」を検証するため、Application Audience（POLICY_AUD）と、組織の Zero Trust ドメイン（TEAM_DOMAIN）の2つを Worker の環境変数として設定します。
Application の Overview 画面に Application Audience の値が、Zero Trust の Settings に Team domain が表示されています。これを後述の wrangler.jsonc に書き込みます。
認証メールが届かない時の対処
Policy を設定したのにログイン用メールが届かないことがあります。多くは「Identity Provider が One-time PIN 以外に設定されている」「Application の Type が間違っている」のどちらかです。
Identity Provider に One-time PIN を追加し、Application Type を Self-hosted にし直すと、ほぼ確実にメールが届くようになります。
ハマったポイント1 — 環境変数とSecret の混在問題
ここからは、実際に詰まった3つの問題を順に書きます。OpenSEO のセットアップで最も時間を奪われたのが、この環境変数まわりです。
Variable と Secret の違いと、混在で起きた不具合
Cloudflare Workers では、設定値の置き場所が「Variable（plain text）」と「Secret（暗号化）」の2種類あります。POLICY_AUD のような公開しても問題ない値は Variable、DataForSEO API キーのような機密情報は Secret に入れるのが原則です。
私たちは最初、同じ値を両方に登録してしまったことがあり、Worker 側が古い値を読み続けて挙動が安定しませんでした。「片方だけに入れる」を厳守すると安定します。
wrangler.jsonc の vars セクション直接編集で解決
Cloudflare のダッシュボード経由で環境変数を編集すると、リポジトリの wrangler.jsonc と差分が出てしまい、次回デプロイ時に上書きされることがあります。
確実な方法は、GitHub 上で wrangler.jsonc の vars セクションを直接編集することです。コミットすると自動で再デプロイがかかり、Worker 側の値が確実に同期されます。
編集はGitHub上で完結する手順
Claude Code を使っているなら、wrangler.jsonc の vars に POLICY_AUD と TEAM_DOMAIN を追記する作業は、GitHub の web エディタからその場で済ませてしまうのが速いです。コミットメッセージは「add access vars」程度で十分です。
自動再デプロイで反映
GitHub のメインブランチに push が走ると、Cloudflare Workers 側で自動的に再デプロイされます。1〜2分で本番に反映されるので、変更内容の確認はその後に行います。
ハマったポイント2 — DATAFORSEO_API_KEY が Worker から読めない
2つ目の落とし穴は、DataForSEO の API キーを Worker が読み込めない、というものでした。Dashboard で登録した Secret が、なぜか Worker 側からは undefined として見えていました。
Dashboardで登録しても認識されないケース
Cloudflare Workers の Dashboard から Secret を登録する方法は、UI上は完了しているように見えても、Worker のバインディング設定と一致していないケースがあります。とくに wrangler.jsonc 側で別名の Secret が定義されている場合、Dashboard の値は読まれません。
wrangler CLI で直接Secret登録する方法
確実なのは、Cloudflare 公式 CLI の wrangler を使って、Secret を直接 push する方法です。Claude Code に「wrangler の CLI で DATAFORSEO_API_KEY を Worker に登録するコマンドを作って実行してください。値はクリップボードから読んでください」と頼めば、コマンドの組み立てとあわせて実行までやってくれます。
値の取り扱い注意
API キーの値は、Private リポジトリであっても wrangler.jsonc に書きません。Git 履歴に永続的に残り、後から消すコストが膨大になるためです。Secret は必ず Cloudflare 側のストレージにのみ保管します。
ハマったポイント3 — DataForSEOアンチフラウドによるアカウント停止
3つ目の落とし穴は、ある意味で最も予想外でした。OpenSEO から DataForSEO への最初のリクエストが、アンチフラウド機能に引っかかってアカウントが一時停止されたのです。
Cloudflareの動的IPが原因の誤検知
Cloudflare Workers は、世界中の Cloudflare エッジから動的なIPで外部APIを叩きます。DataForSEO 側から見ると、「短時間で世界中のIPからアクセスしてくる新規アカウント」に見え、不正利用と判定されたわけです。
サポートチャットで数分解除
DataForSEO のサポートチャットに「OpenSEO 経由で自社用にセルフホストしている。Cloudflare Workers なので IP が分散して見える」と伝えたところ、数分でアカウントの制限が解除されました。事務的にやってくれるので、慌てなくて大丈夫です。
事前に伝えておくと安全
アカウント開設直後に、サポートチャットに対して「Cloudflare Workers から API を叩く構成です」と一言伝えておくと、そもそも停止されません。これから始める方は、開設直後にこれをやっておくとスムーズです。
MCP接続の最終仕上げ
ここまでで Worker は動く状態になっています。最後に Claude Code から MCP 経由で接続する仕上げに入ります。
Managed OAuth を ON にする
Cloudflare Access の Application 設定で、Managed OAuth を ON にします。これにより、Claude Code 側からブラウザを開く認可フローが利用できるようになります。ON にしないと、Claude Code から繋ぎにいったときに認証が通りません。
~/.claude.json への mcpServers 追加
Claude Code の設定ファイル ~/.claude.json の mcpServers セクションに、OpenSEO の Worker URL を MCP サーバとして登録します。ここも Claude Code に「OpenSEO の MCP を ~/.claude.json に追加してください。URL はこれです」と頼めば一発で終わります。
OpenSEO スキル7本のインストール
続けて OpenSEO の公式スキル7本（seo-coach / keyword-research / keyword-clustering / competitor-analysis / competitive-landscape / link-prospecting / seo-project-setup）を ~/.claude/skills/ 配下にインストールします。スキルは git clone で取得できる構成になっています。
Claude Code 再起動と /mcp 接続確認
Claude Code を再起動し、/mcp コマンドで openseo サーバが「connected」と表示されていれば成功です。「authenticate」のリンクが出ている場合は、初回の OAuth 認可フローを進めるとそのまま接続されます。
初回ブラウザ認可フロー
初回だけブラウザで Cloudflare Access のログイン画面が開き、メールに届く One-time PIN を入力すると、以降は自動で接続が維持されます。
動作確認 — whoami と list_projects で接続テスト
最終確認として、Claude Code から OpenSEO の MCP ツールを2つ叩きます。
認証情報の確認
Claude Code に「openseo の whoami を実行して、認証情報が返るか確認してください」と頼みます。アカウント情報が返ってくれば、Cloudflare Access の認証も、DataForSEO API キーの読み込みも、すべて正常です。
プロジェクト一覧取得
続けて「openseo の list_projects を実行してください」と頼むと、OpenSEO 内部のプロジェクト一覧が返ります（初期は空でも問題ありません）。これで「Claude Code → MCP → OpenSEO → DataForSEO」のラインが完全に開通しました。
これで何ができるようになるか
導入完了後、Claude Code からは OpenSEO の16個の MCP ツールが呼び出せる状態になります。
提供される16個のMCPツール一覧と用途
主なツールは次のとおりです。
- research_keywords / get_keyword_search_volume: キーワードの検索ボリュームと関連語の取得
- get_serp_results / get_local_serp_results: SERP（検索結果）の取得
- find_serp_competitors: 特定キーワードでの競合サイト発見
- get_domain_overview / get_domain_keyword_suggestions / get_ranked_keywords: ドメイン単位での分析
- get_backlinks_overview: 被リンクプロファイル
- get_rank_tracker: 順位追跡
- get_google_business_questions / search_local_businesses: ローカル SEO 関連
- list_projects / list_saved_keywords / save_keywords: プロジェクト管理
- whoami: 認証確認
7スキルの役割と使い分け
スキル側は、これらのツールを「SEO業務の流れ」に沿って組み合わせてくれるレイヤです。seo-coach は対話型のコーチ役、keyword-research はキーワード発掘、keyword-clustering は意図別グルーピング、competitor-analysis / competitive-landscape は競合分析、link-prospecting は被リンク戦略、seo-project-setup はワークスペース整備、と役割が明確に分かれています。
既存のSEOワークフローとの統合方針
私たちは、これらを Search Console データやMicroCMS既存記事リストと組み合わせて、「ボリュームがあって既存記事でカバーされていない領域」を自動で抽出する流れを組み立てています。OpenSEO 単体ではなく、社内の他データと合わせることで本領を発揮します。
コスト総括
Cloudflare Workers 無料枠の十分性
Cloudflare Workers は1日10万リクエスト、R2 は10GBまでが無料枠です。OpenSEO の利用程度ではほぼ無料の範囲で収まります。
DataForSEO 従量課金の現実的な月額目安
DataForSEO のキーワード系 API は、1リクエストあたり数セント以下の単価です。週に数回のリサーチで使う運用なら、月数ドル〜十数ドル程度に収まる感覚です。SaaSの月額数百ドルと比較すると桁違いに安い水準です。
Backlinksは別契約（必要な時だけ）
前述のとおり Backlinks API は月100ドル最低コミットなので、必要な月だけ単発で契約するのが現実的です。Keyword と SERP だけで運用する場合は契約不要です。
中小企業がSEOにAIを取り入れる第一歩として
いきなりすべてを自動化する必要はない
SEO業務全体をいきなり AI に任せる必要はありません。むしろ最初は「キーワード発見だけ AI に任せる」「競合の流入キーワードを月1回だけ AI に出してもらう」のような、小さな範囲から始めるのが安全です。
KW発見だけ自動化する小さく始める提案
OpenSEO の keyword-research スキル1本だけでも、人間が思いつかないキーワードが定期的に出てきます。これだけでも、年間で書ける記事の量と質が変わります。中小企業の SEO 担当者がまず触るべきはここです。
コンテンツ執筆そのものは人間の判断が中核
一方で、コンテンツ執筆そのものを AI に任せきると、検索エンジン側の「実体験ベースの一次情報を持つコンテンツを評価する」という方針と逆走します。AI が出すのは草案・素材・候補までで、最終的な選定と書き込みは人間が握るのが現実解です。
ビジネス活用フィルターの重要性
SEO ツールの導入で陥りがちなのが、「データは取れたけれど、自社の事業判断に結びつかない」という状態です。私たちが OpenSEO の導入を進めるうえで最も意識したのは、「これは自社のどの事業の、どの判断を速くするために使うのか」というビジネス活用フィルターを常に通すことでした。
Claude Code に頼めば、何でも分析できてしまいます。だからこそ、「自社が次の3ヶ月で何を達成したいか」を先に決め、そこに必要な分析だけを回す、という規律が必要です。技術的に動かす以上に、ここを設計できるかどうかで、ツール導入の費用対効果は何倍も変わります。
関連記事
OpenSEO は MCP サーバの設定が中核なので、MCP の基礎を押さえておくと運用がさらに安定します。
既存の Search Console データと組み合わせる方法は、こちらの記事で詳しく書いています。
API キー類の安全な管理方法は、長期運用での事故防止に直結します。
まとめ
本記事の要点は次のとおりです。
- OpenSEO は Semrush 級の機能を Cloudflare Workers + DataForSEO 従量課金で再現できるオープンソースSEOツール
- セルフホストの最大の利点は、固定費を抑えつつ、同じ仕組みを将来クライアントに展開できる再現性にある
- セットアップは「DataForSEO 契約 → Cloudflare Workers デプロイ → Cloudflare Access 認証 → MCP 接続」の4段階
- 環境変数とSecret の混在、API キーの読み込み、アンチフラウド誤検知、の3つが代表的な詰まりどころ
- Cloudflare Workers は無料枠で十分、DataForSEO も月数ドル〜十数ドル規模に収まる
- SEO業務全体を一気に AI に置き換えるのではなく、まずキーワード発見だけ自動化して小さく始めるのが現実的
- 技術的に動かすこと以上に、自社の事業判断にどう結びつけるかというビジネス活用フィルターが重要
SEO業務に AI を組み込む第一歩としては、これ以上の構成は当面出てこないと思える完成度です。固定費を抑えながら、自社の SEO ワークフローを継続的に強化していく基盤として、ぜひ手を動かしてみてください。
「Claude Code を自分で使いこなしたい」「自社の業務に組み込みたい」
── そんな方は、まず初回無料相談でお話ししてみませんか。
御社の業務に合わせたClaude Code導入支援
「AIツールを導入したが、現場で使われない」を終わらせる。
業務課題のヒアリングから設計、ハンズオン実践、運用定着まで一貫して支援します。