交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里，以及如何使用你的 API 密钥。
Use the Lovely Router data tool "搜索 1688 批发商品" (id `1688-products`, 1688) 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/1688-products (public, no key needed). Price: $0.0072 / product + $0.0074 / call.
- Run: POST https://lovelyrouter.com/v1/tools/1688-products/run with a body like `{"input":{"keywords":["phone case"],"maxResults":5},"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 "1688-products".
- 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>输入
keywordsarrayEnglish or Chinese search words, one search each.
offerIdsarray1688 product ids to fetch directly (no search).
sortBystringHow to sort search results.
relevance · bestSelling · priceAsc · priceDesc
priceMinintegerUnit price at least this, in CNY.
priceMaxintegerUnit price at most this, in CNY.
minOrderQuantityintegerSuppliers whose minimum order is at most this.
merchantTypestringFilter by supplier verification tier.Super Factory (超级工厂): top-tier manufacturers with verified production capacity.Verified Merchant (实力商家): trusted sellers with strong track records.
any · superFactory · verifiedMerchant
provincestringFilter suppliers by province. Use Chinese name, e.g. 广东 (Guangdong), 浙江 (Zhejiang), 江苏 (Jiangsu).
citystringFilter suppliers by city. Use Chinese name, e.g. 深圳市 (Shenzhen), 广州市 (Guangzhou), 义乌市 (Yiwu).
excludeKeywordsarrayDrop products whose title contains any of these words. Case-insensitive, Chinese or English.Useful when a search term has a second meaning: 刀模夹板 (die board) also returns hair straighteners (电夹板), and 毛毡 (felt) also returns felt handbags. Adding 直发, 卷发 or 包 removes them.Excluded products do not…
试一试
在代码中调用
了解运行、轮询与计费 →curl https://lovelyrouter.com/v1/tools/1688-products/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"input":{"keywords":["phone case"],"maxResults":5},"max_results":20}'# MCP (agents): suggest_tools → get_tool → run_tool
run_tool({
"tool": "1688-products",
"input": {"keywords":["phone case"],"maxResults":5},
"max_results": 20
})费用示例
| 结果 | 运行次数（每次最多 500 条） | 成本 |
|---|---|---|
| 100 | 1 | $0.727 |
| 1,000 | 2 | $7.21 |
| 10,000 | 20 | $72.15 |
预付费，无需订阅。返回的结果少于请求数量时费用更低。 价格
适用场景
常见问题
搜索 1688 批发商品 API 的价格是多少？
$0.0072 / product + $0.0074 / call。以每次最多 500 条获取 1,000 条结果，费用为 $7.21。无需订阅：从预付费余额中扣除。
一次运行返回多少条结果？
默认 20 条，每次最多 500 条。用 max_results 限制单次数量：只为实际交付的结果付费。
需要 1688 账号或 API 密钥吗？
不需要。用你的 Lovely Router API 密钥调用工具即可获得 JSON，无需在 1688 上做任何设置。
AI 智能体可以使用这个工具吗？
可以。把 Claude Code、Cursor 或任何 MCP 客户端连接到 Lovely Router 的 MCP 服务器：智能体用 suggest_tools 找到这个工具，再用 run_tool 和 id 1688-products 运行它。
运行失败会怎样？
失败或被停止的运行只为已交付的结果付费，不收调用费。运行开始时会冻结最高费用，结算后释放剩余部分。