bestblogs-fetcher

BestBlogs Fetcher

Fetch content from BestBlogs.dev OpenAPI. Supports articles, podcasts, videos, tweets, newsletters, and source management.

For full API parameter details, read references/api_reference.md.

Auth

All requests require header X-API-KEY. Read the key from environment variable BESTBLOGS_API_KEY:

-H "X-API-KEY: $BESTBLOGS_API_KEY"

If BESTBLOGS_API_KEY is not set, prompt the user to configure it.

Default Fetch Strategy

When user does not specify filters, use these defaults:

Fetch Plan (5 parallel requests, max ~500 items)

# 1. AI articles (100 items)
curl -s -X POST https://api.bestblogs.dev/openapi/v1/resource/list \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY" \
  -d '{"timeFilter":"3d","sortType":"score_desc","userLanguage":"zh_CN","pageSize":100,"type":"ARTICLE","category":"Artificial_Intelligence"}'

# 2. Non-AI articles: Programming + Business + Product (100 items)
curl -s -X POST https://api.bestblogs.dev/openapi/v1/resource/list \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY" \
  -d '{"timeFilter":"3d","sortType":"score_desc","userLanguage":"zh_CN","pageSize":100,"type":"ARTICLE","category":"Programming_Technology"}'
# Note: also fetch Business_Tech and Product_Development if needed, or omit category to get all non-AI articles

# 3. Videos (50 items)
curl -s -X POST https://api.bestblogs.dev/openapi/v1/resource/list \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY" \
  -d '{"timeFilter":"3d","sortType":"score_desc","userLanguage":"zh_CN","pageSize":50,"type":"VIDEO"}'

# 4. Podcasts (50 items)
curl -s -X POST https://api.bestblogs.dev/openapi/v1/resource/list \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY" \
  -d '{"timeFilter":"3d","sortType":"score_desc","userLanguage":"zh_CN","pageSize":50,"type":"PODCAST"}'

# 5. Tweets (200 items, use tweet endpoint)
curl -s -X POST https://api.bestblogs.dev/openapi/v1/tweet/list \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY" \
  -d '{"timeFilter":"3d","language":"all","sortType":"score_desc","userLanguage":"zh_CN","pageSize":100}'
# Fetch page 2 for tweets if needed (to reach 200)

Run all 5 requests in parallel. After fetching, client-side filter score >= 85, then deduplicate and merge.

Adjusting Parameters

Adjust based on user input:

Other Operations

Get Article Markdown Content

curl -s "https://api.bestblogs.dev/openapi/v1/resource/markdown?id={RESOURCE_ID}" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY"

Returns the article body as Markdown text (in data field). Returns null if content doesn't exist.

Get Latest Newsletter

curl -s -X POST https://api.bestblogs.dev/openapi/v1/newsletter/list \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY" \
  -d '{"pageSize":1,"userLanguage":"zh_CN"}'

Then get details:

curl -s "https://api.bestblogs.dev/openapi/v1/newsletter/get?id={NEWSLETTER_ID}&language=zh_CN" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY"

Available Endpoints

For complete request/response field details, see references/api_reference.md.

Core Workflow

Step 1: Fetch All Pages

Make parallel requests per the Default Fetch Strategy. Check totalCount / pageCount and continue paginating until all data is retrieved.

Step 2: Client-side Filter & Deduplicate

Step 3: Output Full Details

Output all API detail fields for each item. Do NOT summarize or compress — downstream skills need full data for quality assessment.

Output Format

Use readUrl (BestBlogs 站内链接) for all links. Use url only as fallback when readUrl is absent.

Articles / Podcasts / Videos

## BestBlogs 内容列表 (YYYY-MM-DD, 近 X 天，共 N 篇)

---

### 1. [文章标题](readUrl)
- **来源**: 来源名称 | **作者**: 作者 1, 作者 2 | **评分**: 96 | **字数**: 6835 | **阅读时间**: 28 分钟
- **分类**: 人工智能 > AI 模型
- **一句话摘要**: oneSentenceSummary 内容
- **详细摘要**: summary 完整内容（不截断）
- **主要观点**:
  1. **观点标题**: 详细解释说明
  2. **观点标题**: 详细解释说明
  3. **观点标题**: 详细解释说明
- **文章金句**:
  - "金句原文 1"
  - "金句原文 2"
  - "金句原文 3"
- **标签**: 标签 1, 标签 2, 标签 3
- **发布时间**: publishDateTimeStr

---

### 2. [文章标题](readUrl)
...

Tweets

### 1. [推文标题](readUrl)
- **作者**: @username | **评分**: 91 | **影响力**: 90
- **互动**: 👍 446 🔁 134 💬 36 💾 28 👁 45K
- **一句话摘要**: oneSentenceSummary
- **详细摘要**: summary 完整内容
- **主要观点**:
  1. **观点标题**: 详细解释
- **金句**:
  - "金句原文"
- **标签**: 标签 1, 标签 2
- **发布时间**: publishDateTimeStr

Output Completeness Rules

Error Handling

Common Filters Quick Reference