Synapse — Geo Growth Layer

Synapse — GEO 成長レイヤー

バイブコーダーがリリース前に必ず実行する GEO チェックです。

npx synapse check

Synapse は、AI コーディングエージェント（Cursor、Claude Code、Windsurf、v0、 Bolt、Lovable）に新しいプロダクトを発見されやすく、推薦されやすくする CLI ＋ MCP サーバー ＋リンターです。プロジェクトのパスまたは URL に対して synapse check を実行すると、0～100 の成長スコア、失敗したルールの一覧、1 コマンドで適用できる自動修正が表示されます。

パッケージ

パッケージ	説明
@synapse/geo-lint	24 ルールの GEO リンターです。プログラムから使う API：lint(target) → LintReport。
@synapse/cli	init、check、fix、deploy、status を備えた CLI です。synapse としてインストールされます。
synapse	npx synapse の UX 向けの薄いメタラッパーです。
@synapse/mcp-server	6 つのツール、3 つのリソース、3 つのプロンプトを公開する MCP サーバーです。Stdio ＋ストリーム可能な HTTP に対応しています。

クイックスタート

# In a fresh project:
npx @synapse/cli init           # scaffolds synapse.config.json + tracker stub
npx @synapse/cli check          # 24-rule lint, prints scored report
npx @synapse/cli fix            # apply auto-fixes (llms.txt, robots.txt, agent-answer)

# With an account:
export SYNAPSE_API_KEY=…
npx @synapse/cli deploy         # register the site, get a /s/<slug> dashboard
npx @synapse/cli status         # live agent-mention stats

MCP のインストール

Synapse は MCP サーバーとして動作するため、どのエージェントからでもビルドセッション中に geo_check、geo_fix、geo_track_init、geo_prompts、geo_status、geo_corpus_query を直接呼び出せます。

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "synapse-geo": {
      "command": "npx",
      "args": ["-y", "@synapse/mcp-server"],
      "env": { "SYNAPSE_API_KEY": "" }
    }
  }
}

Claude Code

claude mcp add synapse-geo -- npx -y @synapse/mcp-server

Windsurf — ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "synapse-geo": { "command": "npx", "args": ["-y", "@synapse/mcp-server"] }
  }
}

Cline — VS Code の設定

cline.mcpServers に追加します：

"synapse-geo": { "command": "npx", "args": ["-y", "@synapse/mcp-server"] }

Continue — config.json

{
  "mcpServers": [
    { "name": "synapse-geo", "command": "npx", "args": ["-y", "@synapse/mcp-server"] }
  ]
}

Zed — ~/.config/zed/settings.json

{
  "context_servers": {
    "synapse-geo": {
      "command": { "path": "npx", "args": ["-y", "@synapse/mcp-server"] }
    }
  }
}

モノレポ開発

pnpm install
pnpm build                      # builds all packages
pnpm test                       # runs vitest in packages/geo-lint
node packages/cli/dist/index.js check https://example.com
node packages/mcp-server/dist/index.js   # stdio MCP server
PORT=8787 node packages/mcp-server/dist/http.js   # streamable HTTP

認証モデル

対象	読み取り専用ツール	書き込み／アカウント用ツール
CLI	init、check、fix はアカウントなしで使用できます	deploy、status には SYNAPSE_API_KEY が必要です
MCP	geo_check、geo_prompts、geo_status、geo_corpus_query は認証なしで使用できます	geo_fix、geo_track_init には SYNAPSE_API_KEY が必要です

Web アプリ ＋バックエンド（apps/web）

このリポジトリ内にあります。Next.js 14（App Router）＋ Supabase です。Founding 1000 の期間中は無料で、Stripe もペイウォールもありません。

ページ：/、/install、/guide、/methodology、/leaderboard、/discover、 /corpus、/s/[slug]（動的 OG ＋デフォルトのバッジ SVG を使用）。

公開アセット：/llms.txt、/llms-full.txt、/sitemap.xml、/robots.txt、 /.well-known/agent-answer.json、/discover.json、/s.js（トラッカービーコン）。

Supabase を使用する API ルート：

ルート	目的
POST /api/sites	新しいサイトを登録します（synapse deploy で使用）。
POST /api/events	トラッカービーコンのエンドポイントです。CORS に対応しています。
GET /api/sites/[slug]/status	ダッシュボードのライブデータです。
GET /api/corpus	公開コーパスのスナップショットです。
GET/POST /api/recommend?intent=…	エージェント向けの推薦エンドポイントです。
POST /api/cli-telemetry	匿名の CLI 使用イベントです。

動作確認の結果：Synapse は自らのリンターで 98/100（グレード A） を獲得します。

デプロイ

1. Supabase：プロジェクトを作成してから、 apps/web/supabase/migrations/0001_init.sql を実行します（SQL エディターに貼り付けるか、 psql $SUPABASE_DB_URL -f … を実行します）。RLS は公開対象サイトの読み取りを許可するよう 設定されています。すべての書き込みは API ルートからサービスロールを通じて行われます。
2. 環境変数：apps/web/.env.example を .env.local にコピーし、 NEXT_PUBLIC_SUPABASE_URL、NEXT_PUBLIC_SUPABASE_ANON_KEY、 SUPABASE_SERVICE_ROLE_KEY、NEXT_PUBLIC_SITE_URL を設定します。
3. Vercel：apps/web を Vercel プロジェクトにリンクして、デプロイします。

   vercel link --cwd apps/web
   vercel env add NEXT_PUBLIC_SUPABASE_URL
   vercel env add NEXT_PUBLIC_SUPABASE_ANON_KEY
   vercel env add SUPABASE_SERVICE_ROLE_KEY
   vercel env add NEXT_PUBLIC_SITE_URL
   vercel --prod --cwd apps/web --yes
   

Supabase が設定されていない場合、各対象は明確なエラーを表示して処理を安全に停止します。 ホームページと /install は、Supabase がなくても静的に表示されます。

ライセンス

MIT