交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里，以及如何使用你的 API 密钥。
Use the Lovely Router data tool "搜索 Reddit 帖子" (id `reddit-search`, Reddit) 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/reddit-search (public, no key needed). Price: $0.0057 / post.
- Run: POST https://lovelyrouter.com/v1/tools/reddit-search/run with a body like `{"input":{"queries":["best budget mechanical keyboard"],"maxPosts":10,"timeframe":"year"},"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 "reddit-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>输入
queriesarraySearch phrases, one search each. With subredditName, they search inside that subreddit.
maxPostsintegerPosts per search, subreddit or link. The run's max_results caps the total and is split evenly across them.
sortstringrelevance (default): posts about the words. top, hot, new and comments rank every post that merely mentions the words (often only in its body), so across all of Reddit they return mostly off-topic posts: use them with subredditName (that community's top, newest or most discussed posts).
relevance · hot · top · new · comments
timeframestringOnly posts from the past hour, day, week, month or year (default all). Applies to searches and to subredditName.
all · year · month · week · day · hour
subredditNamestringOne subreddit, without r/ (e.g. LocalLLaMA): its posts ranked by sort within timeframe, or a search inside it when queries are given.
urlsarrayReddit links instead of searches: a post, a subreddit listing (https://www.reddit.com/r/LocalLLaMA/top/?t=week), a search inside a subreddit (https://www.reddit.com/r/LocalLLaMA/search/?q=api&restrict_sr=1&sort=top&t=month) or a user page. reddit.com/search links sorted by top or new have the same problem as sort.
试一试
在代码中调用
了解运行、轮询与计费 →curl https://lovelyrouter.com/v1/tools/reddit-search/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"input":{"queries":["best budget mechanical keyboard"],"maxPosts":10,"timeframe":"year"},"max_results":20}'# MCP (agents): suggest_tools → get_tool → run_tool
run_tool({
"tool": "reddit-search",
"input": {"queries":["best budget mechanical keyboard"],"maxPosts":10,"timeframe":"year"},
"max_results": 20
})费用示例
| 结果 | 运行次数（每次最多 500 条） | 成本 |
|---|---|---|
| 100 | 1 | $0.57 |
| 1,000 | 2 | $5.70 |
| 10,000 | 20 | $57.00 |
预付费，无需订阅。返回的结果少于请求数量时费用更低。 价格
适用场景
常见问题
搜索 Reddit 帖子 API 的价格是多少？
$0.0057 / post。以每次最多 500 条获取 1,000 条结果，费用为 $5.70。无需订阅：从预付费余额中扣除。
这是Reddit 爬虫吗？
是的。如果你在搜索Reddit 爬虫、Reddit 搜索 API或Reddit 帖子抓取，这就是：按搜索词或版块获取 Reddit 帖子：标题、正文、得分、评论数、作者、日期。
一次运行返回多少条结果？
默认 20 条，每次最多 500 条。用 max_results 限制单次数量：只为实际交付的结果付费。
需要 Reddit 账号或 API 密钥吗？
不需要。用你的 Lovely Router API 密钥调用工具即可获得 JSON，无需在 Reddit 上做任何设置。
AI 智能体可以使用这个工具吗？
可以。把 Claude Code、Cursor 或任何 MCP 客户端连接到 Lovely Router 的 MCP 服务器：智能体用 suggest_tools 找到这个工具，再用 run_tool 和 id reddit-search 运行它。
运行失败会怎样？
失败或被停止的运行只为已交付的结果付费，不收调用费。运行开始时会冻结最高费用，结算后释放剩余部分。