使用场景

对比竞品，按播放和点赞对标 YouTube Shorts

Q: 可以用 Shorts 标签页链接代替 handle 吗？

可以。把 Shorts 标签页 URL 或单条 Short 的链接放进 startUrls。

Q: 每次运行最多能获取多少条 Shorts？

最多 200 条。maxItems 设置你要求的数量。

Q: 每条 Short 包含什么？

标题、播放量、点赞、评论数和日期。

以 JSON 获取任意 YouTube 频道的 Shorts，含标题、播放量、点赞、评论数和日期，用来与竞品对标短视频表现。

获取 API 密钥查看文档

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

你在发 Shorts，却不知道 2 万播放算不算好。对手每周发三条，其中一条爆了，但他们的频道页把数字埋在长视频底下。Lovely Router 替你读取频道的 Shorts：传入 handle，每条 Short 返回一个 JSON 对象，按 Short 数量从预付费余额中计费。用一个 API 密钥，就能从脚本或 AI 智能体中运行。

交给你的 AI 智能体

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

对比竞品，按播放和点赞对标 YouTube Shorts. 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>

工作原理

选择频道
你自己的频道、直接竞品，以及同一领域里你欣赏的几位创作者。使用 handle，或每个频道 Shorts 标签页的链接。
设置上限后运行工具
发送到 POST /v1/tools/youtube-shorts/run，用 maxItems 指定 Shorts 数量，并用 max_results 作为运行上限。运行会从你的余额中预留它的最高费用，并以 JSON 返回 Shorts。
建立你的基准线
计算每个频道播放量的中位数和前 10% 的水平。用竞品的中位数来衡量你自己的 Shorts，而不是拿某一条爆款当参照。

一次请求获取频道的 Shorts

获取 YouTube Shorts在 youtubeHandles 中接受频道 handle。你也可以在 startUrls 中传入 Shorts 标签页 URL（如 https://www.youtube.com/@MrBeast/shorts）或单条 Short 的链接：

Shell

curl https://lovelyrouter.com/v1/tools/youtube-shorts/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "youtubeHandles": ["@MrBeast"],
      "maxItems": 3
    },
    "max_results": 3
  }'

运行超过 60 秒仍未结束时会返回 202；轮询方法见运行工具。一次运行最多可返回 200 条 Shorts。

每条 Short 包含什么

Field group	What you get
标识	标题
触达	播放量
互动	点赞和评论数
时间	发布日期

使用方案

设定播放量基准。

拉取五个竞品最近的 50 条 Shorts，写下各自的播放量中位数。这个数字就是你所在领域一条普通 Short 能拿到的成绩。

找出爆款并研究标题。

按播放量对一个频道的 Shorts 排序，取前五条，让模型分析这些标题有什么共同点。

检查发布节奏。

根据日期统计每周的 Shorts 数量，并与播放量对照，看多发是有帮助还是只会稀释效果。

比较 Shorts 与长视频。

对同样的频道运行 youtube-channel，比较两种形式下每次上传的播放量。

按月汇报。

为每个频道、每个月维护一张表，供客户或团队查看。

更想用自然语言？连接 MCP 服务器，然后告诉 Claude Code 或 Cursor："获取 @MrBeast 和 @MarkRober 最新的 40 条 Shorts，比较每条 Short 的播放量和点赞中位数，并列出每个频道播放量前三的 Shorts。把 max_results 设为 80。"