vischeck

vischeck

vischeck 是一个小型本地桥接程序，连接到 FrontStat 托管的 MCP 服务，该服务会追踪 AI 搜索引擎是否推荐某个初创公司的 产品。询问某次发布，答案会显示可见度评分，以及 ChatGPT、 Claude 和 Gemini 是否会针对买家的问题提及该产品，或者 它们改为提及哪些竞品。

该桥接程序本身不保存任何可见度数据。它会在本地提供上游 服务的工具列表，内容与从实时端点捕获的完全一致，并将每次 工具调用转发到上游，原样返回结果。 捕获到的全部功能只会读取数据：一个无需令牌的公开发布 查询，以及五个需要 FrontStat Pro 仪表板令牌的 Pro 报告视图。

工具

• check_public_launch — 查询 FrontStat 已追踪的产品发布： 产品名称、本周或本月发布榜单上的排名、可见度评分 （0 到 100），以及 ChatGPT、Claude 和 Gemini 是否会针对买家的问题推荐该产品、它们改为提及的 产品，以及该产品的 FrontStat 公开页面链接。如果尚未追踪 该域名，会说明这一点并链接到免费报告。必需参数： domain（产品的域名或 URL，例如 example.com）。无需令牌。
• get_visibility — 你最新的 FrontStat Pro 报告： 日期、可见度评分、每个 AI 搜索引擎是否会针对你的主要买家 问题推荐你的产品，以及它改为提及的产品；还会按买家问题 和助手列出有多少答案推荐了你（X 个，共 Y 个）。 需要 Pro 令牌。不接受参数。
• list_buyer_questions — FrontStat 会向 AI 搜索引擎询问的 关于你所在市场的每个买家问题，并按引擎列出回答是否推荐 你的产品（是或否）。需要 Pro 令牌。不接受参数。
• who_wins_instead — AI 搜索引擎改为提及的产品，以及它们 引用的网站；每项都会列出它出现在多少个答案中，数据来自 你最新的 Pro 报告。需要 Pro 令牌。不接受参数。
• cited_sites — AI 搜索引擎回答你的买家问题时最常引用的 网站，并列出引用每个网站的答案数，不包含你自己所在的 域名：也就是值得争取被提及的页面。需要 Pro 令牌。 不接受参数。
• visibility_history — 过去 30 天每天一个数据点：你的可见度 评分，以及推荐你产品的答案数，让你了解所做的改动是否影响了 AI 搜索引擎。需要 Pro 令牌。不接受参数。

配置

• FRONTSTAT_MCP_URL（可选）— 覆盖上游端点。默认值为 https://frontstat.com/api/mcp。 （此覆盖钩子是本次重建自行标注的还原内容。）
• FRONTSTAT_API_KEY（可选）— 设置后，每个上游请求都会携带 Authorization: Bearer <value> 标头，五个 Pro 工具正是通过它 接收仪表板令牌的。未设置时，不会发送 Authorization 标头， 只有公开发布查询可用。（此转发机制也是本次重建自行标注的 还原内容；原始功能是在不提供密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：先发送 JSON-RPC initialize 请求（protocolVersion 为 2025-03-26，clientInfo 名称为 vischeck），然后发送 notifications/initialized 通知，接着发送携带调用方原样参数的 tools/call 请求。当上游 在 initialize 响应中返回 Mcp-Session-Id 标头时， 该值会随该会话的每个后续请求发送；此会话会在进程运行期间 持续复用。响应可能是普通 JSON，也可能是服务器发送事件； 两种格式都会读取。

上游的成功结果会原样传递，包括上游设置的任何 isError 标志。 失败情况——JSON-RPC 错误、非 2xx 状态、无法读取的响应，或 无法完成的请求——会作为 isError 结果返回，文本以 vischeck error: 开头（此呈现方式是本次重建自行标注的 还原内容）。

命令行

每个工具也是一个子命令，接受一个 JSON 参数 字符串（不需要参数的工具可省略）：

npx @reneturcios/vischeck check_public_launch '{"domain":"example.com"}'
npx @reneturcios/vischeck get_visibility
npx @reneturcios/vischeck who_wins_instead '{}'
npx @reneturcios/vischeck visibility_history
npx @reneturcios/vischeck --version

退出代码：成功时为 0，结果包含 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/vischeck mcp

MCP 客户端配置：

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

Docker

docker run -i ghcr.io/cloudcorprecords/vischeck
docker run --rm ghcr.io/cloudcorprecords/vischeck --version

容器的默认命令是 mcp，因此第一种形式是 stdio MCP 服务；其他参数都会正常传递给命令行。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全使用桩接的 JSON-RPC 上游服务运行，不会进行实时网络调用。

许可证

MIT——详见 LICENSE。