Threads 已成为客户、创作者和记者对新品发布做出反应的地方，而应用内的关键词搜索并不能给你一张可以保存、可以对比的表格。Lovely Router 可以。发送关键词、话题标签或用户名，每个帖子返回一个 JSON 对象，按帖子数从预付费余额中计费。
交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里，以及如何使用你的 API 密钥。
追踪 Threads 上的品牌与关键词讨论. 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 inputs (links, keywords or accounts) and how many results you need>工作原理
选择模式
关键词和话题标签用
search，某个账号自己的帖子用posts，一条帖子及其回复用thread。设置上限后运行工具
把输入连同
max_results发送到POST /v1/tools/threads-posts/run。运行会从你的余额中预留它的最高费用，并以 JSON 返回帖子。划定时间窗口并对比
用
postedAfter和postedBefore把每次运行限定在一个日期范围内，这样定时运行就不会重复收集昨天的帖子。
一次请求获取某个关键词的 Threads 帖子
Threads 帖子获取接受一个 mode 及其对应的输入。使用 search 时，把关键词或话题标签放在 keywords 中，并用 maxItems 限制行数：
curl https://lovelyrouter.com/v1/tools/threads-posts/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"mode": "search",
"keywords": [
"coffee roaster brooklyn"
],
"postedAfter": "2026-10-01",
"maxItems": 50
},
"max_results": 50
}'其他模式还有 posts、replies、reposts、profile、thread 和 users。账号通过 usernames 传入，帖子串通过 postUrls 传入。运行超过 60 秒仍未结束时会返回 202；轮询方法见运行工具。
每个帖子包含什么
| 字段组 | 你会得到 |
|---|---|
| 内容 | 帖子正文和媒体 |
| 互动 | 点赞、回复、转发和浏览量 |
| 时间 | 日期 |
profile 模式还会返回账号的粉丝数、简介、链接和联系方式。请依法使用他人的数据，包括遵守你所在地的隐私和反垃圾信息规定，责任由你自己承担。
实用配方
用你的品牌名搜索，把 postedAfter 设为昨天，并把新帖子发送给团队。
在发布后的一周内搜索你的产品名和话题标签，按浏览量和点赞数排序，阅读排名靠前的帖子。
对他们的账号使用 posts 模式，按帖子类型比较点赞数和浏览量。
切换到 thread 模式并传入 postUrls，读取一条帖子及其回复。
搜索你的主题，按点赞数给帖子排名，列出出现次数最多的账号作为接触对象。
更想直接用自然语言提问？连接 MCP 服务器，然后对 Claude Code 或 Cursor 说："在 Threads 上搜索话题标签 #specialtycoffee，从上周一开始，取 100 个帖子，告诉我互动最多的三个帖子以及它们说了什么。把 max_results 设为 100。"
费用说明
按帖子付费：启动运行时会预留它的最高费用，即每次调用费加上每个帖子费乘以 max_results，结束后按实际返回的结果结算，预留的剩余部分退回你的余额。失败或超时的运行只为已交付的帖子付费，在开始时就被拒绝的运行不收费。
每天收集 100 个帖子，就按每天 100 个帖子计费。没有订阅，也没有每月最低消费：最低充值 $5，工具和模型共用一个余额。上方卡片显示的是当前价格；价格页面列出了所有工具。
常见问题
可以按话题标签搜索吗？+
可以。在 search 模式下，把话题标签或关键词放进 keywords，# 号可有可无。
怎样避免多次运行之间出现重复？+
把 postedAfter 设为你上一次运行的日期；如果想要一个封闭的时间窗口，再设置 postedBefore。
一次运行最多能返回多少个帖子？+
最多 100 个，用 max_results 设置。
能读取回复吗？+
可以。用 replies 模式读取某个账号的回复，或用 thread 模式读取一条帖子及其回复。
需要订阅吗？+
不需要。你向预付费余额充值，每次运行从中扣费。失败的运行只为已交付的结果付费，不会自动续费。