When to Use
- The user wants to know the most talked-about content for a given period (today / this week / this month).
- The user has no specific topic and just wants to discover high-quality trending content.
- The user specifies a language filter (Chinese / English content).
Primitives
| Primitive | CLI | Description |
|---|---|---|
bestblogs.trending.week |
bestblogs trending --period week --json |
Weekly Trending (default) |
bestblogs.trending.today |
bestblogs trending --period today --json |
Today's Trending |
bestblogs.trending.month |
bestblogs trending --period month --json |
Monthly Trending |
bestblogs.trending.week.en |
bestblogs trending --period week --lang en_US --json |
English Trending |
bestblogs.trending.week.zh |
bestblogs trending --period week --lang zh_CN --json |
Chinese Trending |
Core Action: Weekly Trending
bestblogs trending --period week --limit 20 --json
Returns:
{
"success": true,
"data": {
"period": "week",
"candidates": [
{
"resourceId": "RAW_xxx",
"title": "Vibe Coding 实战指南",
"url": "https://...",
"resourceType": "ARTICLE",
"language": "zh_CN",
"score": 95,
"sourceName": "InfoQ",
"summary": "…"
}
]
}
}
Display Suggestions:
- Sort by
scorein descending order (the CLI has already sorted them), with high-scoring content first. sourceNamehelps users judge the credibility of the source.- When
languageis present, use language tags to distinguish Chinese and English content.
Period Selection Suggestions
| Scenario | Recommended Period |
|---|---|
| User asks "what's trending today" | today |
| User asks "recently / this week" | week(default) |
| User wants to do a monthly review | month |
Language Filtering
# 只看英文内容
bestblogs trending --lang en_US --json
# 只看中文内容
bestblogs trending --lang zh_CN --json
Error Handling
429 / RATE_LIMITED→ retry later.- Empty list → return "No trending content available", and suggest changing the period or removing the language filter.
Combination Suggestions
- When you see an item of interest, chain-call the
bestblogs-readskill for an in-depth read - Want to explore from a topic perspective? Use the
bestblogs-topicskill to view Topic details (the topic dimension is more focused) - Use together with
bestblogs-brief: trending gives macro-level popularity, brief gives today's picks