brandcheck

Name: brandcheck
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords商业与营销01 周前更新

代码仓库

关于 brandcheck

brandcheck 是用于衡量品牌是否出现在 AI 推荐回答中的 MCP 服务和命令行工具。它将买家问题发送至 AskedThrice，并返回服务商回答、分档结论、品牌胜出次数及被提及的竞争对手。

主要功能

01发起品牌可见度测量
02按运行 ID 获取结果
03报告结论及竞争对手提及情况
04支持命令行和 MCP 服务

适用场景

01检查品牌是否出现在 AI 推荐中
02对比品牌与指定竞争对手的提及情况

MCP 相关

向 MCP 客户端提供 `start_visibility_check` 和 `get_visibility_check`，并将请求转发至托管的 AskedThrice 服务。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y @reneturcios/brandcheck

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/brandcheck0.1.0stdio

ocighcr.io/cloudcorprecords/brandcheck:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
runId	string	是	来自 start_visibility_check

详细介绍

brandcheck

当买家向 AI 助手询问推荐时，你的品牌真的会出现吗？brandcheck 是一个小型的免密钥桥接服务，连接托管的 AskedThrice 测量服务。该服务会向 OpenAI、Anthropic 和 Gemini 提出真实买家问题，并报告它们实际给出的回答——而非它们声称自己会给出的回答。

这里没有 0 到 100 的评分。测量完成后，会给出分为三个档次的判定、品牌赢得了多少个买家问题、哪些竞争对手取代了品牌，以及哪些服务提供商实际作出了回答。该服务免费、无需注册或 API 密钥，并且每个域名每 30 天可测量一次；此配额由上游管理，quota_reached 回答会由此客户端原样传递。

工具

start_visibility_check — 为某个品牌开始测量。必填：brand（客户填写的品牌名称）、website（域名，例如 yourbrand.com）和 category（用通俗语言描述该企业销售的商品或服务）。可选：competitors（最多 5 个真实竞争对手，以逗号分隔）、location（企业参与竞争的地点）和 language（en 或 es，即买家问题所用的语言）。返回 runId。
get_visibility_check — 根据 runId 获取测量结果。当服务提供商仍在回答时，返回状态 running，因此请每隔 20 到 30 秒轮询一次（测量约需一分钟）；准备就绪后，会报告判定和计数。

本地不会进行任何校验或计数：参数会按原样转发，上游结果内容也会原样返回，包括任何 isError 标记。

配置

ASKEDTHRICE_MCP_URL（可选）— 覆盖托管端点。默认值为 https://mcp.askedthrice.com/mcp。
ASKEDTHRICE_TIMEOUT_MS（可选）— 每个请求的超时时间，单位为毫秒。默认值为 60000。

失败时会采用三种呈现方式（本次重建自有的标记）：上游返回 JSON-RPC 错误时，显示为 askedthrice error: <message>；上游响应无法解析时，显示为 askedthrice error: malformed response；请求无法完成（包括超时）时，显示为 askedthrice unreachable。

转发机制

桥接内部是一个带标记的重建（Streamable HTTP 会话模式）：首次调用时，客户端会 POST 一个 initialize 请求（protocolVersion 2025-03-26、空 capabilities、clientInfo name brandcheck），在收到 mcp-session-id 响应标头时将其记录下来，随后 POST notifications/initialized，再 POST tools/call 请求，并在已记录会话标头的情况下将其附加到请求中。会话会在进程的整个生命周期内复用。每个 POST 都携带 Content-Type: application/json 和 Accept: application/json, text/event-stream，响应可能是纯 JSON 或 SSE。

CLI

每个工具都是一个子命令，接收一个 JSON 参数字符串：

npx @reneturcios/brandcheck start_visibility_check '{"brand":"Acme","website":"acme.com","category":"project management tool","competitors":"Asana, Monday"}'
npx @reneturcios/brandcheck get_visibility_check '{"runId":"run-123"}'
npx @reneturcios/brandcheck --version

输出为转发结果内容的 JSON。退出代码：成功时为 0，结果带有 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/brandcheck mcp

MCP 客户端配置：

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

Docker

docker run -i ghcr.io/cloudcorprecords/brandcheck
docker run --rm ghcr.io/cloudcorprecords/brandcheck get_visibility_check '{"runId":"run-123"}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source