bestblogs-topic

bestblogs-topic — Topic Exploration

When to Use

• The user wants to know what topic pages BestBlogs has.
• The user wants to dive deep into a specific topic (e.g. "AI programming", "Vibe Coding").
• The user wants to filter topics by type (event type / domain type / person-organization type / comparison type).

Primitives

Primitive	CLI	Description
bestblogs.topic.list	bestblogs topics list --json	Browse all topics (Chinese by default)
bestblogs.topic.list.en	bestblogs topics list --lang en --json	English topic list
bestblogs.topic.list.filter	bestblogs topics list --type DOMAIN --json	Filter topics by type
bestblogs.topic.get	bestblogs topics get <slug> --json	View topic details
bestblogs.topic.get.en	bestblogs topics get <slug> --lang en --json	English version of topic details

Core Action: Browse Topic List

bestblogs topics list --lang zh --json

Returns:

{
  "success": true,
  "data": {
    "topics": [
      {
        "slug": "vibe-coding",
        "type": "DOMAIN",
        "title": "Vibe Coding",
        "summary": "AI 辅助编程的全新范式……",
        "tagCodes": ["AI_CODING", "LLM"],
        "publishedAt": "2026-04-20T00:00:00Z",
        "pinnedOrder": 1
      }
    ],
    "totalCount": 12
  }
}

Display Suggestions：

• pinnedOrder Not null → pinned topic, displayed first (lower number comes first).
• type Enum meanings:
  • EVENT — event type (in-depth interpretation of a specific event)
  • DOMAIN — domain type (systematic overview of a technology/direction)
  • PERSON_ORG — person/organization type (comprehensive interpretation of a person or company)
  • COMPARISON — comparison type (comparative analysis of multiple options/solutions)
• tagCodes Helps users understand the technical domains covered by topics.

View Topic Details

bestblogs topics get vibe-coding --lang zh --json

The returned topic object contains:

• title / summary / type / language
• hasZhVersion / hasEnVersion — whether a bilingual version exists
• eventContent / domainContent / personOrgContent / comparisonContent — detailed content body corresponding to the type (only non-null for the corresponding type)
• references — footnote reference list (including in-site resource titles)
• furtherReadingResources — extended reading resource snapshot (resourceId → resource metadata)

# 查看英文版
bestblogs topics get vibe-coding --lang en --json

Topic Type Filtering

# 只看领域型主题
bestblogs topics list --type DOMAIN --json

# 只看事件型主题（英文）
bestblogs topics list --type EVENT --lang en --json

Error Handling

• 404 / NOT_FOUND on topics get <slug> → topic does not exist or is not published; suggest using topics list to check available slugs.
• 404 and there is a language parameter → that language version has not been published yet; try the other language (hasZhVersion / hasEnVersion field previews the available version).
• Empty list → no published topics for that type/language.

Combination Suggestions

• After discovering a topic of interest, pick a resourceId from furtherReadingResources , and chain-call the bestblogs-read skill for in-depth reading
• bestblogs-trending gives popular cross-cutting sections,bestblogs-topic gives in-depth topic perspectives — use them together
• references contains in-site resource references, from which you can select highly relevant content to continue exploring