# creator_lookup

> 查找创作者并评估体量。

URL: https://mcp-docs.opennomos.com/zh/docs/tools/research/creator_lookup

> 查找创作者并评估体量。action=youtube_search（`query`，例如 'indie hacker'）→ 返回频道及订阅数文本；约 5 秒，$0.001。action=xiaohongshu_search（用中文 `query`，例如 '独立开发'）→ 返回用户及粉丝数文本；约 3 秒，$0.01。action=xiaohongshu_notes（`id` = xiaohongshu_search 返回的用户 id）→ 直接返回其近期笔记；约 3 秒，$0.01。action=x_profile（`id` = 不带 @ 的账号名）→ 粉丝、帖子数、简介、网站；约 3 秒，$0.001。action=tiktok_creator（`id` = 数字形式的 TikTok 用户 id）→ 粉丝、获赞；约 3 秒，$0.001。>
> 搜索和资料查询返回结果；xiaohongshu_notes 返回笔记，不保存记忆。

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

| 字段 | 值 |
| --- | --- |
| 工具包 | Creators (`creators`) |
| 每次调用的预估成本 | ~$0.01（上游成本；各 action 的具体数字见描述） |
| 工具包每月上限 | 上游成本 $2（不向用户显示） |
| 项目 | 可选（`project` 或 `X-OpenNomos-Project`）；只是把项目 id 附在结果里 |

## 参数

| 参数 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| `project` | 否 | `string` | 项目 slug 或 id。省略则用凭据或工作区的默认项目。 |
| `action` | 是 | `"youtube_search"` \| `"xiaohongshu_search"` \| `"xiaohongshu_notes"` \| `"x_profile"` \| `"tiktok_creator"` | 要查什么；每个 action 使用 `query` 还是 `id`，见上面的工具描述。 |
| `query` | 否 | `string` | youtube_search / xiaohongshu_search：搜索文本，例如 'indie hacker' 或 '独立开发'。 |
| `id` | 否 | `string` | xiaohongshu_notes:xiaohongshu_search 返回的用户 id。x_profile：账号名，例如 'levelsio'（@ 可有可无）。tiktok_creator：数字形式的 TikTok 用户 id。 |

## 示例调用

```json
{
  "action": "xiaohongshu_search",
  "query": "独立开发"
}
```

REST:`POST https://service.opennomos.com/v1/tools/creator_lookup`，以上 JSON 作为请求体。MCP:`tools/call`,`name: "creator_lookup"`，以上 JSON 作为 `arguments`。

## 示例结果

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

```json
{
  "results": [
    {
      "platform": "xiaohongshu",
      "id": "5f1a…",
      "name": "…",
      "red_id": "…",
      "followers": "1.2万粉丝",
      "description": "…",
      "verified": false,
      "url": "https://www.xiaohongshu.com/user/profile/5f1a…"
    }
  ]
}
```

## 说明

- 五个 action:`youtube_search`、`xiaohongshu_search`、`xiaohongshu_notes`、`x_profile` 和 `tiktok_creator`。每个用 `query` 还是 `id`，见上面的描述。
- `x_profile` 针对一个账号名返回粉丝数、关注数、帖子数、简介和网站。`xiaohongshu_notes` 返回某位创作者的近期笔记，笔记链接带有打开它所需的 `xsec_token`。
- 搜索得到的粉丝数是来源页面上显示的文本（例如 `1.2万粉丝`），不是数字。

## 错误

上游出问题时，会在一个**正常结果里**以 `error`、`reason` 和 `action` 报告（适用时还有 `tool` / `retry_after_seconds`）。对 `search_signals`，这会按来源分别出现。见[错误](https://mcp-docs.opennomos.com/zh/docs/reference/errors.md)。

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