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 返回笔记,不保存记忆。
以上是服务端发布的英文描述的译文;英文原文见英文页。工具名、参数名和取值保持原样。
| 字段 | 值 |
|---|---|
| 工具包 | 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。 |
示例调用
{
"action": "xiaohongshu_search",
"query": "独立开发"
}REST:POST https://service.opennomos.com/v1/tools/creator_lookup,以上 JSON 作为请求体。MCP:tools/call,name: "creator_lookup",以上 JSON 作为 arguments。
示例结果
示例里的值是示意性的;结构来自服务端代码。
{
"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,这会按来源分别出现。见错误。
这个工具属于 Creators 工具包。如果该包没有启用,调用会以 pack_required(HTTP 403)失败;如果该包的每月上游成本上限已用完,会以 soft_limit(HTTP 429)失败。两者都带 action: "give_up_and_tell_user" 和控制台 URL。