交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里，以及如何使用你的 API 密钥。
Use the Lovely Router data tool "搜索 X（Twitter）帖子" (id `x-search`, X (Twitter)) to get data for me. It returns JSON.
- Docs (read first): https://lovelyrouter.com/docs/tools/run.md and https://lovelyrouter.com/docs/api/tools.md
- Input fields and price: GET https://lovelyrouter.com/v1/tools/x-search (public, no key needed). Price: $0.000388 / tweet.
- Run: POST https://lovelyrouter.com/v1/tools/x-search/run with a body like `{"input":{"searchTerms":["\"gemini argon\" min_faves:50 -filter:replies since:2026-10-01 lang:en"],"maxItems":20,"queryType":"Top"},"max_results":10}`. 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 (up to 500 per run).
- If you support MCP, you can instead connect the server https://lovelyrouter.com/mcp (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool with tool "x-search".
- 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: <describe the data you need, e.g. which places, profiles, keywords or URLs, and the output format>输入
searchTermsstring[]One query per entry, written like X's search box; combine operators with spaces, OR and parentheses. Words and "exact phrase"; a OR b; -word / -"phrase" to exclude; #hashtag; @mention; $cashtag; from:user, to:user (replies to them), -from:user; lang:en; since:2026-10-01 / until:2026-10-15 (UTC dates); min_faves:100, min_retweets:20, min_replies:5; filter:replies or -filter:replies; filter:media, filter:images, filter:videos, filter:links (prefix - to exclude); -filter:retweets; url:example.com; conversation_id:; list:. X API-only operators (is:retweet, has:media, place:) are not applied: use the filter: forms. Example: "gemini argon" min_faves:50 -filter:replies since:2026-10-01 lang:en
maxItemsintegerOptional result cap across the whole run. Without a spend cap, Xquik uses its built-in default. Diagnostic rows count toward this cap. The form starts at 1,000. A run can return 100,000 rows & more, so raise it for a full export.
queryTypestringLatest returns newest first. Top is ranked by relevance and is not exhaustive. Latest + Top returns both without duplicates and fills your limit from either. Account timelines ignore this setting.
Latest · Top · Latest + Top
langstringFilter tweets by language using a 2-letter ISO 639-1 code. Every returned tweet matches this language.
twitterHandlesstring[]X usernames whose posts to collect. Profile Tweets matches the Posts tab on X, with posts, reposts & the author's replies to their own posts. Add Exclude replies under Tweet type filters for original posts only. Profile With Replies keeps target-authored posts and replies. Add usernames with or without @. For example, elonmusk, @nasa.
试一试
在代码中调用
了解运行、轮询与计费 →curl https://lovelyrouter.com/v1/tools/x-search/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"input":{"searchTerms":["\"gemini argon\" min_faves:50 -filter:replies since:2026-10-01 lang:en"],"maxItems":20,"queryType":"Top"},"max_results":20}'# MCP (agents): suggest_tools → get_tool → run_tool
run_tool({
"tool": "x-search",
"input": {"searchTerms":["\"gemini argon\" min_faves:50 -filter:replies since:2026-10-01 lang:en"],"maxItems":20,"queryType":"Top"},
"max_results": 20
})费用示例
| 结果 | 运行次数（每次最多 500 条） | 成本 |
|---|---|---|
| 100 | 1 | $0.039 |
| 1,000 | 2 | $0.388 |
| 10,000 | 20 | $3.88 |
预付费，无需订阅。返回的结果少于请求数量时费用更低。 价格
适用场景
常见问题
搜索 X（Twitter）帖子 API 的价格是多少？
$0.000388 / tweet。以每次最多 500 条获取 1,000 条结果，费用为 $0.388。无需订阅：从预付费余额中扣除。
这是推特爬虫吗？
是的。如果你在搜索推特爬虫、Twitter 搜索 API或推特数据抓取，这就是：匹配关键词、话题标签或指定账号的推文：内容、作者、互动数据、日期。
一次运行返回多少条结果？
默认 20 条，每次最多 500 条。用 max_results 限制单次数量：只为实际交付的结果付费。
需要 X (Twitter) 账号或 API 密钥吗？
不需要。用你的 Lovely Router API 密钥调用工具即可获得 JSON，无需在 X (Twitter) 上做任何设置。
AI 智能体可以使用这个工具吗？
可以。把 Claude Code、Cursor 或任何 MCP 客户端连接到 Lovely Router 的 MCP 服务器：智能体用 suggest_tools 找到这个工具，再用 run_tool 和 id x-search 运行它。
运行失败会怎样？
失败或被停止的运行只为已交付的结果付费，不收调用费。运行开始时会冻结最高费用，结算后释放剩余部分。