OpenNomos文档
工具调研

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否stringfacebook_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。

本页目录