CallAI SEO

CallAI — AI エージェント向けのリアルタイム SEO データ

中文说明

CallAI は推測ではなく、実際の検索データを AI エージェントに提供します。Google と Bing のリアルタイム検索結果（Google AI Overview と、そこから引用されているサイトを含む）、キーワードの検索ボリュームと難易度、ロングテールのアイデア、競合とのキーワードギャップ、ドメインのトラフィック、バックリンク、ページ内監査を利用できます。

2 通りの方法で使えます。

• DeepSeek Harness（dsh）プラグイン — この npm パッケージ、@callaiapi/seo です。ツールに加えて、キーワード調査、競合分析、GEO チェック、監査の方法をエージェントに教える callai-seo スキルをインストールします。
• リモート MCP サーバー — https://api.callaiapi.com/mcp。Claude Code、Cursor、VS Code、Cline、Windsurf など、あらゆる MCP クライアントで利用できます。インストールは不要です。

データは DataForSEO から取得されます。有料ツールは、呼び出しごとに CallAI の残高から料金が引き落とされます。$1 からチャージでき、サブスクリプションは不要で、残高に有効期限はありません。各結果には、その呼び出しにかかった料金が表示されます。7 つの無料ツールは API キーだけで利用できます。キーがなくても、誰でもツールの一覧を確認できます。

---

目次

• 1. API キーを取得する
• 2. DeepSeek Harness にインストールする
• 3. その他の MCP クライアントで使う
• 4. 質問の例
• 5. ツールのリファレンス
• 6. 市場：地域と言語のコード
• 7. 料金とコスト管理
• 8. トラブルシューティング
• 9. よくある質問

---

1. API キーを取得する

1. https://callaiapi.com/register で登録します。
2. $1 以上の金額をチャージします（カード、Apple Pay／Google Pay、または複数のチェーンの USDT に対応）。
3. API Keys でキーを作成します：https://callaiapi.com/portal?tab=keys。キーは sk-live-… のような形式です。キーごとに利用上限を設定できます。

2. DeepSeek Harness にインストールする

dsh 0.2.0 以降が必要です。

dsh plugin --profile web add @callaiapi/seo

別のプロファイルを使っている場合は、web の代わりに使用中のプロファイル名を指定します（ls ~/.dsh/profiles）。dsh-plugin-shop などのプラグインショップから @callaiapi/seo をインストールすることもできます。その後、dsh を再起動してください。新しく追加したプラグインは、実行中のプロセスには読み込まれません。

プラグインにキーを設定する

プラグインは次の順にキーを検索し、最初に見つかったものを使用します。

場所	方法
プラグイン設定 apiKey	プロファイルの cordis.patch.yml（下記）、または dsh のビルドに表示される場合はプラグインの設定ページ
dsh の認証情報 CALLAI_API_KEY	dsh の認証情報設定から保存するか、~/.dsh/.credentials.yaml の refs の下、または ~/.dsh/.env（web など、認証情報サービスを備えたプロファイル）に設定します
環境変数 CALLAI_API_KEY	CALLAI_API_KEY=sk-live-… dsh web — headless を含む、すべてのプロファイルで動作します

~/.dsh/profiles/<profile>/cordis.patch.yml に設定するプロファイルパッチ：

- id: callai-seo
  config:
    apiKey: sk-live-your-key

~/.dsh/.env に設定する .env ファイル：

CALLAI_API_KEY=sk-live-your-key

dsh の認証情報を保存すると、自動的に再接続されます。パッチファイル、.env、または環境変数の変更は、dsh の再起動後に反映されます。

動作を確認する

セッションを開始し、「どの mcp__callai ツールが使えますか？」 と尋ねます。エージェントが 20 個のツールを一覧表示し、「https://example.com を監査して」 と依頼すると、実際のデータと billed_usd の行が返されるはずです。

プラグイン設定

設定	デフォルト	説明
apiKey	空	CallAI のキーです。空の場合は、CALLAI_API_KEY の認証情報または環境変数が使用されます
url	https://api.callaiapi.com/mcp	MCP エンドポイントです。別のエンドポイントを指定された場合にのみ変更してください
toolCallTimeoutMs	120000	呼び出しごとのタイムアウトです。詳細な SERP やバックリンクの呼び出しには最大 1 分かかることがあります

アンインストール

dsh plugin --profile web remove @callaiapi/seo

3. 他の MCP クライアントで使用する

設定	値
トランスポート	Streamable HTTP
URL	https://api.callaiapi.com/mcp
ヘッダー	Authorization: Bearer sk-live-your-key

Claude Code

claude mcp add --transport http callai https://api.callaiapi.com/mcp \
  --header "Authorization: Bearer sk-live-your-key"

Cursor — プロジェクト内の .cursor/mcp.json、または ~/.cursor/mcp.json：

{
  "mcpServers": {
    "callai": {
      "url": "https://api.callaiapi.com/mcp",
      "headers": { "Authorization": "Bearer sk-live-your-key" }
    }
  }
}

VS Code（Copilot エージェントモード） — .vscode/mcp.json：

{
  "inputs": [
    { "type": "promptString", "id": "callai-key", "description": "CallAI API key", "password": true }
  ],
  "servers": {
    "callai": {
      "type": "http",
      "url": "https://api.callaiapi.com/mcp",
      "headers": { "Authorization": "Bearer ${input:callai-key}" }
    }
  }
}

Windsurf、Cline、その他のクライアント — 上記の URL とヘッダーを使って、リモート／Streamable HTTP サーバーを追加します。ローカル（stdio）サーバーのみをサポートするクライアントでは、mcp-remote を使ってブリッジできます。

{
  "mcpServers": {
    "callai": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.callaiapi.com/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer sk-live-your-key" }
    }
  }
}

4. 質問のしかた

ツールを自分で呼び出す必要はありません。作業内容を説明すれば、エージェントがツールを選択します。例：

• 「英国のスタンディングデスクに関するロングテールキーワードを、難易度 30 未満で探し、上位 3 件の検索順位を確認してください。」
• 「自分のサイト example.com と競合サイト competitor.com を比較してください。トラフィック、自分がランクインしていない競合のキーワード、被リンクの強さを調べてください。」
• 「Google は『best crm for startups』の AI Overview を表示していますか？引用されているサイトはどこですか？その中に自分のサイトはありますか？」
• 「https://example.com/pricing を監査して、修正項目の一覧を作成してください。」
• 「期限切れドメイン old-brand.com の購入を検討しています。被リンクとスパムスコアを確認してください。」
• 「ドイツ語で、ドイツにおける次の 40 個のキーワードの検索ボリュームと CPC を取得してください：…」

5. ツールのリファレンス

dsh ではツールは mcp__callai__<name> として表示され、他のクライアントでは <name> と表示されます。すべての結果は billed_usd（呼び出しにかかった費用）と result を含む JSON です。* 印の付いたパラメーターは必須です。被リンクツールと監査ツールを除くすべてのツールでは、location_code と language_code も指定できます（セクション 6）。

ツール	パラメーター	戻り値
google_serp	keyword*、depth 10～100（デフォルト 10）、device desktop/mobile	順位付きの検索結果（タイトル、URL、ドメイン、スニペット）。Google が AI Overview を表示する場合は、そのテキストと引用元
bing_serp	google_serp と同じ	順位付きの Bing 検索結果
keyword_overview	keywords*（最大 100 件）	キーワードごとの検索ボリューム、CPC、競合度、キーワード難易度 0～100、主な検索意図
keyword_ideas	keyword*、limit 1～200（デフォルト 50）、max_difficulty 0～100	シードキーワードを含むロングテールキーワード。ボリューム順で、同じ指標を含みます
ranked_keywords	target* ドメイン、limit 1～200（デフォルト 50）	ドメインがランクインしているキーワード。推定トラフィック順で、順位、ランクインしている URL、各種指標を含みます
domain_overview	target* ドメイン	推定オーガニックトラフィック、ランクインしているキーワード数、順位分布、有料検索の合計
keyword_gap	competitor、your_domain、limit 1～200（デフォルト 50）	競合がランクインしていて自分はランクインしていないキーワード。ボリューム順で、競合の順位と URL を含みます
backlinks_summary	target* ドメイン	ドメインランク 0～1000、被リンク数、参照ドメイン数、nofollow 数、リンク切れの被リンク数、スパムスコア、初回検出日
referring_domains	target* ドメイン、limit 1～200（デフォルト 50）	リンク元ドメイン。強い順で、ランク、被リンク数、スパムスコア、初回検出日を含みます
page_audit	url*	ステータスコード、タイトル、メタディスクリプション、canonical、見出し、単語数、リンク数と画像数、所要時間、オンページスコア、すべてのチェック項目
dataforseo_request	path*、method POST/GET、body	その他の DataForSEO v3 エンドポイント — Google マップ、YouTube、Amazon キーワード、Google Trends、LLM への言及、WHOIS、テクノロジー、非同期の task_post／task_get
domain_check_start	domains*（最大 100 件）、dry_run、rules	アーカイブ履歴、Baidu インデックス、被リンクをチェックします。ドメインごとに課金され、約 $0.02 です。dry_run を指定すると、課金なしで費用を返します
domain_check_results	check_id*、verdict、limit、after	進捗状況と、ドメインごとの判定、理由、事実。読み取りは無料です

無料ツール

API キーが必要ですが、アカウントごとに 1 日あたり 200 ユニットの上限内であれば残高は不要です。keyword_suggestions は seed モードで 1 ユニット、questions で 3 ユニット、az で 5 ユニットを消費し、それ以外は 1 ユニットを消費します。

ツール	パラメーター	戻り値
keyword_suggestions	keyword*、engines、market、mode seed/questions/az	Google、Bing、YouTube、Amazon、Baidu、DuckDuckGo、Yahoo、Yandex のオートコンプリート候補。検索ボリュームはありません
check_robots	url*	robots.txt のステータスと内容
check_sitemap	url*	robots.txt または /sitemap.xml から見つかったサイトマップ：ステータス、URL 数、サンプル
page_meta	url*、fetch_as bot/googlebot	生の HTML から取得したステータス、最終 URL、タイトル、説明、canonical、robots、X-Robots-Tag、hreflang、H1
redirect_chain	url*	各リダイレクトのステータスと転送先。最大 5 件
dns_lookup	domain*	A、AAAA、CNAME、MX、NS、TXT レコード
email_auth_check	domain*、dkim_selector	MX、SPF、DKIM、DMARC、MTA-STS レコードと、修正が必要な項目の監査結果

ドメインは example.com、www.example.com、または完全な URL で指定できます。

6. 市場：地域と言語コード

デフォルトの市場は米国（location_code 2840）、英語（language_code en）です。エージェントに市場を自然な言葉で伝えると（「ドイツ向けに、ドイツ語で」など）、コードが設定されます。

市場	location_code	一般的な language_code
米国	2840	en
英国	2826	en
カナダ	2124	en / fr
オーストラリア	2036	en
ドイツ	2276	de
フランス	2250	fr
スペイン	2724	es
イタリア	2380	it
ブラジル	2076	pt
日本	2392	ja
インド	2356	en / hi

全リスト：DataForSEO の地域。

7. 料金とコスト管理

呼び出し料金は DataForSEO のコストに CallAI のマージンを加えた金額です。正確な金額は、各結果の billed_usd とコンソールの呼び出しログに記載されています。一般的な料金は次のとおりです。

呼び出し	おおよその料金
google_serp / bing_serp、10 件の結果	$0.0024
keyword_overview、10 個のキーワード	$0.013
keyword_ideas / ranked_keywords / keyword_gap、50 行	$0.018
domain_overview	$0.015
backlinks_summary	$0.029
referring_domains、50 行	約 $0.03
page_audit	$0.0002

キーワード調査を一通り行う場合（アイデアの取得 → 指標の確認 → 5 個のキーワードの SERP チェック）の費用は、通常 $0.10 を大きく下回ります。

支出を予測しやすくするには、次の手順を実施してください。

• コンソールでキーに支出上限を設定します。上限に達すると呼び出しは停止します。
• 同梱のスキルは、エージェントにキーワードをまとめて処理すること、小さな上限から始めること、約 $0.50 を超える費用がかかる実行の前に伝えることを指示します。
• 残高がなくなると、ツールはチャージ用リンクとともに "Insufficient CallAI balance" を返します。拒否された呼び出しには料金がかかりません。

8. トラブルシューティング

問題	解決方法
dsh に mcp__callai__ ツールが表示されない	インストール後に dsh を再起動します。キーが設定されていることを確認してください（セクション 2）。キーがない場合、プラグインは [callai-seo] No API key をログに記録し、ツールを追加しません
401 / "Invalid or inactive API key"	sk-live- を含む完全なキーを使用し、コンソールで有効になっていることを確認します
429 "spend limit reached"	キーの支出上限を引き上げるか、別のキーを使用します
"Insufficient CallAI balance"	https://callaiapi.com/portal?tab=topup でチャージします
Task failed (40501): Invalid Field …	パラメーターが誤っています（例：その市場ではサポートされていない言語）。値を修正して再試行するようエージェントに依頼してください
呼び出しがタイムアウトする	depth または limit を下げるか、toolCallTimeoutMs を引き上げます
dsh にプラグインの互換性がないと表示される	dsh を更新します：npm i -g @deepseek-ai/dsh

9. FAQ

無料枠はありますか？ ありません。新しいアカウントは $0 から始まり、$1 からチャージできます。サブスクリプションはなく、月額最低利用額もありません。

データの取得元はどこですか？ DataForSEO のライブ SERP、Labs、Backlinks、On-Page API です。SERP の結果は呼び出し時にライブで取得されます。キーワード指標とバックリンクインデックスは、DataForSEO の最新データベースを使用します。

どのようなデータを保存しますか？ 請求と呼び出しログのために、各呼び出しのエンドポイント、ステータス、費用、所要時間を保存します。リクエストに応答するため、キーワードとドメインは DataForSEO に送信されます。

エージェントを使わずに API を呼び出せますか？ はい。同じデータを REST API https://api.callaiapi.com/dataforseo/v3/... から DataForSEO のリクエスト形式で利用できます。https://callaiapi.com/en/dataforseo をご覧ください。

すでに DataForSEO アカウントを持っています。 その場合は、DataForSEO を直接利用できます。CallAI は、最低入金額なしで $1 から従量課金を利用したい方、LLM API と残高を共有したい方、エージェント対応の MCP サーバーを利用したい方に向けたサービスです。

リンク

• セットアップガイド：https://callaiapi.com/en/integrations/seo-mcp
• コンソール：https://callaiapi.com/portal
• イシュー：https://github.com/hanshengcc/callai-seo-mcp/issues

ライセンス

MIT