competitor_intel
竞品数据。
竞品数据。action=tech_stack(
domain,用最终域名,如 'notion.com',会重定向的域名会失败)→ CMS/分析/广告/框架、社交账号;约 3 秒,$0.012。action=facebook_ads(query品牌或关键词,country默认 'US')→ 直接返回在投的 Meta 广告(正文、CTA、链接、开始日期);约 12 秒,约 $0.0075(至少 10 条结果)。action=google_ads_advertisers(query品牌名)→ 广告主 id 及大致广告数;很慢,约 75 秒,$0.0024。action=google_ads(advertiser_ids来自上一个 action)→ 直接返回他们的 Google 广告,带首次/最近展示时间;约 14 秒,$0.0024。> 技术栈和广告主搜索返回结果;广告搜索返回数据,不保存记忆。
以上是服务端发布的英文描述的译文;英文原文见英文页。工具名、参数名和取值保持原样。
| 字段 | 值 |
|---|---|
| 工具包 | Competitors (competitors) |
| 每次调用的预估成本 | ~$0.012(上游成本;各 action 的具体数字见描述) |
| 工具包每月上限 | 上游成本 $2(不向用户显示) |
| 项目 | 可选(project 或 X-OpenNomos-Project);只是把项目 id 附在结果里 |
参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
project | 否 | string | 项目 slug 或 id。省略则用凭据或工作区的默认项目。 |
action | 是 | "tech_stack" | "facebook_ads" | "google_ads_advertisers" | "google_ads" | 要查什么;每个 action 需要什么、返回什么,见工具描述。 |
domain | 否 | string | 仅 tech_stack:最终域名,不带协议,例如 'notion.com'。 |
query | 否 | string | facebook_ads / google_ads_advertisers:品牌或关键词,例如 'notion'。 |
advertiser_ids | 否 | string[] | 仅 google_ads:google_ads_advertisers 返回的广告主 id。 |
country | 否 | string | 仅 facebook_ads:两位国家代码,例如 'US'、'GB'、'JP'。默认 'US'。 |
示例调用
{
"action": "tech_stack",
"domain": "notion.com"
}REST:POST https://service.opennomos.com/v1/tools/competitor_intel,以上 JSON 作为请求体。MCP:tools/call,name: "competitor_intel",以上 JSON 作为 arguments。
示例结果
示例里的值是示意性的;结构来自服务端代码。
{
"results": [
{
"…": "technologies, analytics, ads, frameworks and social profiles as returned by the provider"
}
]
}说明
tech_stack请用最终域名:会重定向的域名会失败。google_ads_advertisers很慢(约 75 秒)。把它返回的广告主 id 用于google_ads。facebook_ads无论你传什么,都总是向服务商请求 10 条结果(最小值)。
错误
上游出问题时,会在一个正常结果里以 error、reason 和 action 报告(适用时还有 tool / retry_after_seconds)。对 search_signals,这会按来源分别出现。见错误。
这个工具属于 Competitors 工具包。如果该包没有启用,调用会以 pack_required(HTTP 403)失败;如果该包的每月上游成本上限已用完,会以 soft_limit(HTTP 429)失败。两者都带 action: "give_up_and_tell_user" 和控制台 URL。