mcpField
G
geo-analysis

geo-analysis

github.com/openclaudiaマーケティング・グロース722125 回インストール1 週間前に更新
リポジトリ

geo-analysis について

geo-analysis は、マーケティングチーム向けのドメイン GEO/SEO 分析スキルです。AI での可視性、市場調査、競合状況をまとめた PDF を生成し、ブランド名の修正後に可視性を再計算できます。

主な機能

  1. 01AI でのブランド可視性分析
  2. 02市場と競合の調査
  3. 03PDF レポートの生成
  4. 04ブランド名修正後の可視性再計算

活用シーン

  1. 01ChatGPT と Google AI でのブランド推薦状況の確認
  2. 02顧客向けドメイン分析レポートの作成
  3. 03ブランド別名による可視性結果の修正

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/openclaudia/openclaudia-skills --skill geo-analysis

インストール後、Claude Code で/geo-analysisを入力して読み込まれたか確認します。

詳細

GEO 分析

ドメインの GEO／SEO 分析を一括で実行し、クライアント向けの PDF レポートを取得します。AI での可視性（ChatGPT／Google AI がブランドを推奨しているか）、詳細な市場調査、競合の状況を確認できます。

Enception のクライアント分析 API を利用する薄いラッパーです。操作は start、status、report の 3 つです（ブランド名の修正も任意で行えます）。

開示事項： Enception AI が提供しており、Enception の有料外部 API を呼び出します。ドキュメント：https://www.enception.ai/doc/api-client-analysis

要件

  • ENCEPTION_ANALYSIS_API_KEY — x-api-key ヘッダーとして送信します。セルフサービスの場合：https://www.enception.ai にサインアップし、Account → API Key から無料枠のキーを生成してください（月 2 回の分析が無料です。上限の引き上げについてはチームにお問い合わせください）。レート制限：1 分あたり 10 リクエスト。

1. 開始

POST https://www.enception.ai/api/external/client-analysis/start

必須項目：website_url、primary_region、core_goals。適切なデフォルト値：primary_region=us、core_goals=traffic、output_language=en、competitors=[]。API は URL をドメインのみの形式に正規化し、IP アドレスを拒否します。{ id, message } が返されます — id を保存してください。

output_language は、まず明示的なリクエスト、次にユーザーの会話言語、最後にドメインの TLD（.cn → zh、それ以外 → en）に基づいて選択してください。

curl -s -X POST "https://www.enception.ai/api/external/client-analysis/start" \
  -H "x-api-key: $ENCEPTION_ANALYSIS_API_KEY" -H "Content-Type: application/json" \
  -d '{"website_url":"https://example.com/","primary_region":"us","competitors":[],"core_goals":"traffic","output_language":"en"}'

ユーザーから指定があった場合に限り、primary_region／core_goals／competitors を上書きしてください。core_goals は自由記述です（例：traffic、ranking）。競合：[{"name":"X","domain":"x.com"}, ...]（最大 5 件）。複数のドメインがある場合は、それぞれに POST を 1 回実行し、ID をすべて収集してください。

2. ステータス

POST https://www.enception.ai/api/external/client-analysis/status を本文 { "id": "<id>" }、同じ x-api-key ヘッダーとともに送信します。{ status: 'pending' | 'failed' | 'succeeded', progress_percent?, pdf_url? } が返されます。

一連の処理には約 20～45 分かかります。ボトルネックは詳細な市場調査のステップです。ポーリングは長い間隔（秒単位ではなく、分単位）で行ってください。succeeded ⇒ レポートを取得できます。処理が失敗した場合、またはいつまでも停止したままの場合は、結果を作り上げず、その旨をユーザーに伝えてください。

3. レポート

GET https://www.enception.ai/api/external/client-analysis/report/<id> — 公開されており、認証は不要です。ID を共有できます。ステータスが succeeded になると利用可能です（部分的な処理結果も取得できます）。

curl -s -o geo-analysis-example.pdf \
  "https://www.enception.ai/api/external/client-analysis/report/<id>"

実際に PDF であることを確認してから（file geo-analysis-example.pdf）、ファイルや公開 URL をユーザーに提供してください。

4. 「可視性ゼロ」を修正する（ブランド名の修正）

POST https://www.enception.ai/api/external/client-analysis/update-brand を本文 { "id", "brand_name"?, "alternative_names": [...] }、x-api-key ヘッダーとともに送信します。

レポートで AI の可視性がゼロまたは低く表示されている一方、実際にはブランドが ChatGPT／Google に推奨されている場合、ほとんどの場合、ブランドが結合されたドメイン名（例：pudurobotics）でしか認識されておらず、AI エンジンは「Pudu Robotics」と表記していることが原因です。正式名称と別名を指定すると、このエンドポイントは保存済みの回答から可視性を再計算します（再クエリは不要で、高速です）。その後、レポートを再取得してください。

curl -s -X POST "https://www.enception.ai/api/external/client-analysis/update-brand" \
  -H "x-api-key: $ENCEPTION_ANALYSIS_API_KEY" -H "Content-Type: application/json" \
  -d '{"id":"<id>","brand_name":"Pudu Robotics","alternative_names":["Pudu","PuduBot"]}'

{ success, mention_rate, overall_score, average_position, analysis_regenerated } が返されます。新しい分析ではブランド名が自動的に解決されます。この操作は既存のレポートを手動で修正するためのものです。

コメント

Markdown 対応