使用场景

用 Google Trends 季节性数据做需求与库存规划

Q: 可以选择哪些时间范围？

now 1-h、now 4-h、now 1-d、now 7-d、today 1-m、today 3-m、today 12-m、today 5-y 和 all。

Q: 怎么获取热门搜索？

把 mode 设为 trending，并在 geo 中指定国家，就能获得该国的热门搜索，而不是分析单个关键词。

以 JSON 获取任意关键词的 Google Trends 时间趋势和地区热度，围绕真实的季节性需求规划上新、备货和广告预算。

预付费，无订阅REST 或 MCP一个密钥搞定模型、数据和智能体

凭感觉安排库存、广告预算或内容日历，往往等秋季的需求高峰已经开始，你才发现。Google Trends 能告诉你一件商品的热度何时上升、在哪些地区上升，但只是一张需要手动查看的图表。Lovely Router 替你执行这次查询：发送一个关键词、一个时间范围和一个国家，每次调用返回一个 JSON 对象，按调用次数从预付费余额中计费。用一个 API 密钥，就能从表格脚本、规划任务或 AI 智能体中调用。

交给你的 AI 智能体

把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里，以及如何使用你的 API 密钥。

用 Google Trends 季节性数据做需求与库存规划. 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>

工作原理

选好关键词
列出你围绕其做规划的商品、品类或品牌词，每次调用一个关键词。
指定时间范围和国家后运行工具
向 POST /v1/tools/google-trends/run 发送关键词，把 mode 设为 keyword，再给出 predefinedTimeframe（例如 today 5-y）和 geo 国家代码。加上 fetchRegionalData 即可获得地区分布。
跨年份对比
保存每次结果。把不同年份的同一周对齐，就能看出需求何时起量、何时见顶、何时回落，再倒推出你的下单和上新日期。

一次请求获取季节性需求

Google Trends 热度每次调用接受一个关键词。predefinedTimeframe 支持从 now 1-h 到 today 5-y 以及 all 的取值。geo 是国家代码，留空表示全球。地区分布需要指定一个国家：

Shell

curl https://lovelyrouter.com/v1/tools/google-trends/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "mode": "keyword",
      "keyword": "patio heater",
      "predefinedTimeframe": "today 5-y",
      "geo": "US",
      "fetchRegionalData": true
    },
    "max_results": 1
  }'

一次调用会返回该关键词的时间趋势；如果设置了 fetchRegionalData，还会返回按地区划分的热度。运行超过 60 秒仍未结束时会返回 202；轮询方法见运行工具。

每次调用包含什么

字段组	你得到的内容
关键词	你查询的词，对应你设置的时间范围和国家
时间趋势	该关键词的热度在所选时间范围内如何变化
地区热度	开启 `fetchRegionalData` 并指定国家后，热度在各地区的分布

Trends 给出的是相对热度，而不是搜索量。用它来对比不同的周、年份和地区，不要用它来统计搜索次数。