工具调研
ai_visibility
用给定的问题去查询 ChatGPT 公开的、未登录的搜索界面。
用给定的问题去查询 ChatGPT 公开的、未登录的搜索界面。返回 markdown 格式的回答、来源、提到的品牌和搜索子查询。不保存回答。
以上是服务端发布的英文描述的译文；英文原文见英文页。工具名、参数名和取值保持原样。
| 字段 | 值 |
|---|---|
| 工具包 | SEO & AI visibility (seo) |
| 每次调用的预估成本 | ~$0.004（上游成本；各 action 的具体数字见描述） |
| 工具包每月上限 | 上游成本 $3（不向用户显示） |
| 项目 | 可选（project 或 X-OpenNomos-Project）；只是把项目 id 附在结果里 |
参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
project | 否 | string | 项目 slug 或 id。省略则用凭据或工作区的默认项目。 |
question | 是 | string | 要问 ChatGPT 的问题，例如 'best open source CRM for startups'。 |
location_code | 否 | integer (≥ 1) | string | 从哪里搜索：国家名（如 "United States"、"China"、"Hong Kong"、"Japan"）、两位国家代码（"US"、"CN"），或数字形式的 DataForSEO 地区代码（如 2840）。默认 United States。 |
language_code | 否 | string | 语言代码，例如 'en'、'de'、'ja'。默认 'en'。 |
示例调用
{
"question": "best open source CRM for startups",
"location_code": "US",
"language_code": "en"
}REST:POST https://service.opennomos.com/v1/tools/ai_visibility，以上 JSON 作为请求体。MCP:tools/call,name: "ai_visibility"，以上 JSON 作为 arguments。
示例结果
示例里的值是示意性的；结构来自服务端代码。
{
"answer": "Several open source CRMs are popular with startups: …",
"sources": [
{
"url": "https://example.com/best-crms",
"domain": "example.com",
"title": "Best open source CRMs"
}
],
"brands": [
"Twenty",
"SuiteCRM"
],
"fan_out_queries": [
"open source crm for startups",
"self hosted crm"
]
}说明
- 用你给的问题去查询 ChatGPT 公开的未登录搜索界面，返回一条回答。这只是一次采样，不是排名：在得出“我的品牌没出现”的结论之前，请换几种问法多问几次。
- 不保存任何内容。如果服务商没有返回回答，结果是
{ "answer": null }。
错误
上游出问题时，会在一个正常结果里以 error、reason 和 action 报告（适用时还有 tool / retry_after_seconds）。对 search_signals，这会按来源分别出现。见错误。
这个工具属于 SEO & AI visibility 工具包。如果该包没有启用，调用会以 pack_required（HTTP 403）失败；如果该包的每月上游成本上限已用完，会以 soft_limit（HTTP 429）失败。两者都带 action: "give_up_and_tell_user" 和控制台 URL。