Synapse — Geo Growth Layer

Synapse — GEO 增长层

每位氛围编程者在上线前都会运行的 GEO 检查。

npx synapse check

Synapse 是一个 CLI + MCP 服务 + 检查工具，可让新产品更容易被 AI 编码 Agent（Cursor、Claude Code、Windsurf、v0、Bolt、Lovable）发现和推荐。针对项目路径或 URL 运行 synapse check，即可获得 0–100 的增长评分、失败规则列表，以及一键自动修复方案。

软件包

软件包	说明
@synapse/geo-lint	包含 24 条规则的 GEO 检查工具。编程接口：lint(target) → LintReport。
@synapse/cli	提供 init、check、fix、deploy、status 的 CLI。安装后命令为 synapse。
synapse	用于提供 npx synapse 使用体验的轻量元包装器。
@synapse/mcp-server	MCP 服务，提供 6 个工具、3 个资源和 3 个提示词。支持 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 服务的形式运行，因此任何 Agent 都能在构建会话期间直接调用 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"] }
    }
  }
}

Monorepo 开发

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=…	面向 Agent 的推荐端点。
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，每个接口都会安全地拒绝请求并显示清晰错误；即使未配置 Supabase，主页和 /install 仍会以静态方式呈现。

许可证

MIT