你在做网红营销活动，或在开发达人发现、网红筛选工具，需要可以排序比较的红人营销数据：谁在发某个话题的内容、粉丝规模有多大、近期内容表现如何。Lovely Router 以数据工具的形式提供这些数据。按关键词搜索 Instagram、TikTok 和 YouTube，再以 JSON 拉取主页资料、帖子、Reels、Shorts 和 X 主页资料，按结果付费，使用的是与调用模型相同的密钥。
交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里，以及如何使用你的 API 密钥。
Find creators by topic on Instagram, TikTok, YouTube and X, then pull their followers, posts, reels and views. Use the Lovely Router data tools: each returns JSON and is billed per result.
- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.
My task: <the niche, the platforms, the follower range and what to compare>工作原理
按话题查找创作者
用 Instagram 搜索查找与关键词匹配的 Instagram 账号，或用 TikTok 搜索和 YouTube 搜索按关键词搜索视频。每条视频结果都会注明作者或频道。
拉取他们的数据
把找到的账号发给主页和内容类工具：简介和粉丝数、近期帖子和 Reels、YouTube 视频和 Shorts、X 主页资料。
打分并筛选
在你自己的代码中把点赞、评论和播放量与粉丝数进行比较，或者把 JSON 交给模型，让它给出排好序的候选名单。
一次请求搜索 Instagram 创作者
下面这次运行会在 Instagram 上搜索与 "coffee roaster" 匹配的账号，最多返回 20 个：
curl https://lovelyrouter.com/v1/tools/instagram-search/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {"search": "coffee roaster", "searchType": "user", "searchLimit": 20},
"max_results": 20
}'请求最多等待 60 秒。已结束的运行会返回它的 status、charge_usd 中的费用，以及 items 中的账号。耗时更长的运行会返回 202 和一个 poll 路径；轮询和分页的方法见运行工具。
然后查询你想保留的账号。Instagram 主页每个用户名返回一条结果，包含简介、粉丝数、帖子数和近期帖子。不设置 max_results 时，上限就是你列表的长度：
curl https://lovelyrouter.com/v1/tools/instagram-profile/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"input": {"usernames": ["natgeo"]}}'工具一览
按关键词搜索 Instagram 用户、地点或话题标签。
按用户名获取 Instagram 资料：简介、粉丝数、帖子数、近期帖子。
Instagram 账号的近期帖子：文案、点赞、评论数、媒体链接、日期。
Instagram 账号的 Reels：文案、播放、点赞、评论、视频链接、日期。
按关键词或话题标签搜索 TikTok 视频：文案、播放、点赞、分享、作者、音乐。
某个 TikTok 账号的视频，附带作者的粉丝数和获赞数。
按关键词搜索 YouTube 视频，或从 YouTube 链接（搜索结果、频道、播放列表或视频 URL）获取：标题、播放、点赞、评论数、时长、频道、日期。
YouTube 频道的视频（频道名如 @MrBeast 或频道 URL）：标题、播放、点赞、评论数、时长、日期。
YouTube 频道的 Shorts：标题、播放、点赞、评论、日期。
X/Twitter 账号的资料：简介、粉丝、关注、认证状态与各项计数。
| 工具 | 你发送的内容 | 每条结果包含 |
|---|---|---|
instagram-search | search 关键词、searchType（user、hashtag、place 或 popular） | 一个匹配的主页、话题标签或地点，或一条热门 Reel |
instagram-profile | usernames | 简介、粉丝数、帖子数、近期帖子 |
instagram-posts | startUrls（主页 URL 或用户名）、until | 文案、点赞数、评论数、媒体、带粉丝数的发布者信息、日期 |
instagram-reels | startUrls（Reels 标签页或用户名）、until | 文案、播放量、点赞数、评论、视频 URL、日期 |
tiktok-search | keywords、sortType、dateRange、location | 文案、播放量、点赞数、分享数、作者、音乐 |
tiktok-profile | usernames、since、until | 一个视频，附带作者的粉丝数和获赞数 |
youtube-search | keywords | 标题、播放量、点赞数、评论数、时长、频道、日期 |
youtube-channel | youtubeHandles 或频道 URL | 标题、播放量、点赞数、评论数、时长、日期 |
youtube-shorts | youtubeHandles 或 Shorts 标签页 URL | 标题、播放量、点赞数、评论、日期 |
x-profile | twitterHandles | 简介、粉丝数、关注数、认证状态、各项计数 |
每个工具的页面都列出了完整的输入结构和示例输入。不同工具返回结果中的字段名各不相同，所以先跑一次小规模搜索，看看返回了什么。
实用配方
用 "keywords": ["home espresso"]、"sortType": "MOST_LIKED"、"dateRange": "LAST_THREE_MONTHS" 和 "location": "US" 运行 tiktok-search。按作者对视频分组，再对出现次数最多的作者运行 tiktok-profile，查看他们的粉丝数和发布频率。
对每个账号运行 instagram-reels，把 until 设为 90 天前。把每条 Reel 的播放量中位数和 instagram-profile 返回的粉丝数放在一起，就能看出谁仍然能触达自己的受众。
对合作过的创作者运行 instagram-posts，把 until 设为活动开始日期，只返回之后发布的帖子。把推广帖的点赞和评论与其他帖子进行比较。
拿到创作者的各平台账号后，运行 youtube-channel、youtube-shorts 和 x-profile，看看他们在哪个平台的受众最多。
Instagram 话题标签帖子会返回某个话题标签下的帖子及每个帖子的作者，由此得到一份账号列表，可以再传给 instagram-profile。
让智能体来做调研
把 MCP 服务器连接到 Claude Code：
claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
--header "Authorization: Bearer $LOVELY_API_KEY"然后对它说："找出 15 位最近三个月发过家用意式咖啡内容的美国 TikTok 创作者。获取每位创作者的粉丝数和最近 10 个视频的播放量，给我一张按播放量中位数排序的表格。每次运行都设置 max_results，开始之前先告诉我预估费用。"
费用说明
每次运行都从你的预付费余额中扣费：按结果收费（一个主页、一个帖子、一条 Reel、一个视频），设有每次调用费的工具另收该费用。运行开始时，会从你的余额中预留它的最高费用，即每次调用费加上每条结果费乘以 max_results。运行结束时，你为实际返回的结果付费，预留的剩余部分退回余额。失败或超时的运行只为已交付的结果付费，在开始时就被拒绝的运行不收费。
没有订阅，也没有每月最低消费。上方卡片显示的是当前价格，价格页面列出了所有工具。要让一次大范围筛查保持低成本，请先搜索，每次运行都设置 max_results，并只为你保留的账号拉取完整的主页资料和帖子。
常见问题
能按关键词在 Instagram 上搜索创作者吗？+
可以。运行 instagram-search 并把 searchType 设为 user，它会返回与你的关键词匹配的主页。其他搜索类型会返回话题标签、地点或热门 Reels。
可以用哪些数据来衡量互动表现？+
粉丝数来自 Instagram、TikTok 和 X 的主页工具，Instagram 帖子也会附带发布者的粉丝数。每个帖子、Reel 和视频都带有点赞、评论和播放量，因此你可以在自己的代码中计算每位创作者的互动率。
需要 Instagram、TikTok 或 YouTube 账号吗？+
你只需要一个 Lovely Router API 密钥，以及足以支付这次运行的余额。这些工具都不要求登录：你发送的是账号名、主页 URL 或关键词。
一次运行能查多少位创作者？+
主页类工具为你列表中的每个账号返回一条结果，最多不超过该工具每次运行的上限，具体见工具页面。更长的列表请拆成多次运行；最多可以同时进行 10 次运行。
创作者数据属于个人数据吗？+
根据 GDPR 等隐私法规，可识别个人的主页和帖子可能属于个人数据。你有责任依法收集和使用这些数据，可接受使用政策列出了这些工具不得用于哪些用途，例如对个人进行画像，或以法律禁止的方式联系他们。