geoscore

geoscore

ChatGPT、Claude、Perplexityは、あなたのサイトを実際に確認できるのでしょうか？ geoscoreは、AIクローラーや検索に対するウェブサイトの準備状況、つまりGEO（Generative Engine Optimization）をチェックし、すぐにコピーして使える修正用アセットを提供します。具体的には、指定したAIクローラーのアクセスを許可するrobots.txt、Schema.orgのOrganizationおよびFAQマークアップ、llms.txtを生成します。stdio経由でローカル実行でき、アカウントもAPIキーも不要です。

5つのツールが処理を行います。analyze_geo_scoreは、既存ドメインを0〜100で評価し、カテゴリごとの内訳を表示します。get_geo_fixesは、そのドメインの修正キットを生成します。make_site_geo_readyは、サイト名、URL、説明から、新しいサイトに必要なすべてのアセットを一度に生成します。suggest_monitoring_configは、ビジネス向けの監視設定案を作成します。対象ユーザー、推奨クエリ、それを適用するための正確なcausabi.com API呼び出しが含まれます。get_site_reportは、クライアントに提出できるレポートを返します。causabi.comの共有スラッグがある場合はメンション率の詳細な内訳を、ドメインしかない場合はクロール可能性スコアのみを返します。

対応範囲に関する注記

• 一部のみを実装しています — get_product_guideは省略されています。 元のサーバーには6つのツールがあり、6つ目はベンダー独自のガイド文書を返します。その内容は閲覧可能な記録として公開されていないため、誠実な再構築では再現できません。上記の5つのツールのみを実装しています。
• スコアの重み付けは、明記したうえで再構築しています。 元の実装ではチェック項目（クロール可能性、AIクローラーごとのrobots.txt、JavaScriptなしでの表示、Schema.org、FAQ、名称と連絡先、更新状況／アクセシビリティ／llms.txtの衛生状態〔配点は小〕）は公開されていますが、重み付けは公開されていません。geoscoreの配点（クロール可能性20、robots 20、表示20、schema 15、FAQ 10、連絡先10、衛生状態5）は、この再構築で設定したものであり、src/geo.tsに記載されています。
• レポートの通信経路は、再構築したものです。 causabi.com/report/<slug>の共有ページは公開されています。背後にあるAPIのパス（https://causabi.com/api/v1/reports/<slug>）は、その動作をこの再構築で実装したものです。

設定

ありません。環境変数もAPIキーも不要です。サイトの情報は、チェック対象のドメインから直接取得します。リクエストごとのタイムアウトは固定で15秒です。

ツール

• analyze_geo_score — 既存のdomainのGEOスコア（0〜100）と内訳を返します。結果はJSONオブジェクトです：{domain, score, breakdown: {crawlability, robots, visibility, schema, faq, contacts, hygiene}, robots: {<crawler>: "allowed" | "blocked"}, facts: {home_status, has_llms_txt, has_json_ld}}。追跡対象のクローラーは、GPTBot、ClaudeBot、PerplexityBot、ChatGPT-User、Claude-User、OAI-SearchBot、Google-Extended、CCBotの8種類です。ホームページをまったく取得できない場合、ツールはsite unreachable: <domain>で失敗します。HTTPエラーステータスのページにアクセスできる場合は、致命的エラーにはならず、スコアが算出されます。
• get_geo_fixes — domainに対する修正内容を、4つのセクションからなるMarkdownドキュメントで返します。内容は、名前の付いた各AIクローラーを許可するrobots.txtのブロック（現在のrobots.txtでブロックされているクローラーを一覧表示）、サイトのタイトルを特定できる場合はそのタイトルを入力したOrganization JSON-LDテンプレート、FAQPage JSON-LDのスケルトン、llms.txtのスケルトンです。
• make_site_geo_ready — 新しいサイト向けのGEOアセット一式を一度に作成します（APIキーは不要です）。name、url、descriptionに加えて、任意でservices（文字列の配列）、email、faq（{question, answer}の配列）を受け取ります。1つのドキュメントを返します。内容は、Organization JSON-LD、faqが指定されている場合はFAQPage JSON-LDブロック、llms.txtの本文（servicesが指定されている場合はServicesリストを含む）、名前の付いたAIクローラーを許可するrobots.txtです。完全にローカルで動作し、情報を取得するためのリクエストは行いません。
• suggest_monitoring_config — business_nameとbusiness_descriptionから監視設定の草案を作成します。locationは任意です。JSONを返します：{business_name, location, audiences, suggested_queries, apply_calls}。apply_callsには、causabi.comで設定を適用する2つの呼び出し（PUT https://causabi.com/api/v1/monitor/{site_id}/settingsおよびPUT https://causabi.com/api/v1/monitor/{site_id}/queries）が含まれ、{site_id}はプレースホルダーです。このツール自体はAPIを呼び出しません。
• get_site_report — 完全なAI言及率の内訳を得るにはreport_slugを指定します（APIキーは不要です）。クロール可能性スコアのみの概要を得るにはdomainだけを指定します。この概要は、完全なレポートの取得方法を説明するnoteフィールドを含むanalyze_geo_scoreのJSONです。2つの引数のうち、いずれか1つが必須です。

CLI

npx @reneturcios/geoscore analyze_geo_score '{"domain":"example.com"}'
npx @reneturcios/geoscore get_geo_fixes '{"domain":"example.com"}'
npx @reneturcios/geoscore make_site_geo_ready '{"name":"Acme Corp","url":"https://acme.com","description":"We help small businesses grow."}'
npx @reneturcios/geoscore suggest_monitoring_config '{"business_name":"Bright Smiles Dental","business_description":"A family dental clinic.","location":"Austin, TX"}'
npx @reneturcios/geoscore get_site_report '{"report_slug":"abc123"}'
npx @reneturcios/geoscore --version

各サブコマンドは1つのJSON引数文字列を受け取り、ツールの結果テキストを出力します。終了コード：0は成功、1はツールエラー、2は使用方法のエラーです。

MCP

npx -y @reneturcios/geoscore mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "geoscore": {
      "command": "npx",
      "args": ["-y", "@reneturcios/geoscore", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/geoscore          # stdio MCP server (CMD defaults to "mcp")
docker run --rm ghcr.io/cloudcorprecords/geoscore analyze_geo_score '{"domain":"example.com"}'   # CLI via container

開発

npm install
npm run build   # tsc -> dist/ (dist/cli.js is the bin)
npm test        # tsx --test test/*.test.ts — fixture-based, no network
npm run dev     # tsx src/cli.ts — run the CLI from source

ライセンス

MIT — LICENSEを参照してください（Copyright (c) 2026 Rene Turcios）。