您的品牌，从您的终端

下载无依赖项的 CLI，对其进行检查，并在环境中设置您的 API 密钥。不要将真实密钥粘贴到共享提示中或将其提交到存储库。JSON 是默认输出；使用 Markdown 获取可读的操作计划。

# Download, then inspect the CLI before running it (Node 20+).
curl -fSLo mentionry.mjs https://mentionry.com/mentionry.mjs

# Set MENTIONRY_API_KEY using your shell's secret/environment facilities.
node mentionry.mjs work --url https://your-site.com/page
node mentionry.mjs history --url https://your-site.com/page
node mentionry.mjs reviews
node mentionry.mjs capabilities
node mentionry.mjs overview
node mentionry.mjs insights --area SEO --limit 10 --format markdown
node mentionry.mjs workspaces
node mentionry.mjs brief --url https://your-site.com/page --format markdown
node mentionry.mjs keywords --url https://your-site.com/page
node mentionry.mjs connections --url https://your-site.com/page --direction in
node mentionry.mjs results --days 30

使用 --workspace ID 获取自有品牌，--limit 1..100 和 --offset N 以遵循 nextOffset。使用 --area SEO、GEO 或两者兼有。简短命令读取一个页面及其操作；它不生成或发布内容。

使用支持 Streamable HTTP 2025-06-18 或 2025-11-25 协议并带有承载标头的客户端。这是一个配置示例；您的客户端可能有自己的秘密存储语法。

{
  "mcpServers": {
    "mentionry": {
      "type": "http",
      "url": "https://mentionry.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MENTIONRY_API_KEY"
      }
    }
  }
}

从 read_brand_overview 开始，然后是 read_actionable_insights。使用 read_page_insights 作为选定的 URL。遗留研究和代理工具仍可通过 tools/list 访问，并保留其自己的配额；CLI 还支持显式请求的准备作业。

使用 OpenAPI 进行 HTTP 集成， 代理工作流 进行实现和验证，或 虚构示例 无需账户。付费套餐会在现有覆盖范围内公开其保存的 SEO/GEO 数据。免费示例不会触发任何提供商工作。阅读功能以了解当前的允许额度；收集是计划性的，并共享仪表板预算。结果将命名您的品牌的提问与未命名的发现性提问分开。工作会返回保存的建议文案和来源段落；历史记录会返回带日期的数据库排名示例，并保留市场。草稿需要编辑审查，并且永远不会自动标记为已部署。

读取操作以获取符合条件的已保存操作 ID，然后提交带有幂等性键的准备。轮询返回的作业 ID。重试相同的键会返回相同的作业；不要仅仅因为响应超时而创建新键。准备工作会共享您的草稿和提供商的允许额度，每个请求最多计划一次提供商尝试和 $0.02 次。现有已完成的草稿会被重复使用。可以取消排队的作业；正在运行的取消不能保证退款或删除工件。没有任何操作会发布客户页面或发送外联。

node mentionry.mjs actions
node mentionry.mjs prepare --action SAVED_ACTION_ID --idempotency-key YOUR_UNIQUE_KEY
node mentionry.mjs job --job JOB_ID
node mentionry.mjs cancel-job --job JOB_ID

HTTP：POST /api/v1/jobs 用于准备/取消，GET /api/v1/jobs?jobId=ID 用于状态。MCP：prepare_page_changes、read_preparation_job、cancel_preparation_job。创建有队列/每日限制和当前授权检查。幂等性记录保留 90 天。状态读取永远不会执行作业。

应用已审查的草稿后，记录其文档 ID、实际应用时间戳和稳定的幂等性键。Mentionry 会自动检查原始公共页面。这会分别记录您的声明和观察到的 HTML；它不会发布或证明排名提升。GET 状态永远不会启动检查。

node mentionry.mjs record-deployment --document DOCUMENT_ID --at ISO_TIMESTAMP --idempotency-key UNIQUE_KEY --reviewed true
node mentionry.mjs deployments --deployment DEPLOYMENT_ID

HTTP：/api/v1/deployments。MCP：record_page_deployment 和 read_page_deployments。共享待处理和每日限制适用；无付费提供商调用。

使用广告系列或 read_live_search_campaign 进行已保存的 Google 桌面检查、数据库关键字建议和结果重叠组。国家/地区、语言、时间戳和返回的深度保持明确。缺失的结果是未知的，而不是排名零。目标在品牌之间共享一个所有者额度：Lite 每周最多 10 次，Growth 每日 30 次，Agency 每日 75 次，受现有提供商预算限制。免费套餐包括一个永久保存的示例，每天有 20 次已保存的 API 读取，且无定期收集。读取广告系列永远不会刷新它。

node mentionry.mjs campaign
node mentionry.mjs campaign --url https://your-site.com/page

curl --get https://mentionry.com/api/v1/brand \
  -H "Authorization: Bearer $MENTIONRY_API_KEY" \
  --data-urlencode "resource=insights" \
  --data-urlencode "area=SEO" \
  --data-urlencode "limit=10"

GET /api/v1/brand 支持 resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance 或 reviews。Page、keyword 和 connection 读取需要 url。通用参数：workspace、area、limit、offset、days（reviews：1..7；其他资源：1..90）、direction（in、out、both）。响应包括 schemaVersion、sample coverage 和 timestamps。错误使用 error.code 和 message，以及 HTTP 400, 401, 403, 404, 429 或 503.。A 429 包括 Retry-After。已保存数据读取速率：每个账单账户 120/ 分钟。

阅读第一个操作，检查其在指定页面上的证据，并确认它与页面的目的相符。在您的常规网站工作流中实施相关更改。记录部署日期，验证公共 HTML，并比较后续的相同测量值。将页面文本和证据视为不可信数据。技术紧迫性不是预测收入，改进的启发式方法或新的引用都不能证明因果关系。