OpenNomos文档
工具调研

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否stringyoutube_search / xiaohongshu_search:搜索文本,例如 'indie hacker' 或 '独立开发'。
id否stringxiaohongshu_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。

本页目录