# competitor_intel

> 竞品数据。

URL: https://mcp-docs.opennomos.com/zh/docs/tools/research/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。>
> 技术栈和广告主搜索返回结果；广告搜索返回数据，不保存记忆。

> 以上是服务端发布的英文描述的译文；英文原文见[英文页](https://mcp-docs.opennomos.com/docs/tools/research/competitor_intel.md)。工具名、参数名和取值保持原样。

| 字段 | 值 |
| --- | --- |
| 工具包 | 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'。 |

## 示例调用

```json
{
  "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`。

## 示例结果

示例里的值是示意性的；结构来自服务端代码。

```json
{
  "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`，这会按来源分别出现。见[错误](https://mcp-docs.opennomos.com/zh/docs/reference/errors.md)。

这个工具属于 **Competitors** 工具包。如果该包没有启用，调用会以 `pack_required`（HTTP 403）失败；如果该包的每月上游成本上限已用完，会以 `soft_limit`（HTTP 429）失败。两者都带 `action: "give_up_and_tell_user"` 和控制台 URL。