bestblogs-article-recommender

BestBlogs 文章推荐语生成器

为 BestBlogs.dev 内容生成两个版本的中英文推荐语，用于精选周刊展示。推荐语聚焦文章核心观点、关键信息和亮点内容，帮助读者快速判断是否值得阅读。

认证

需要以下环境变量：

OpenAPI 请求（获取内容数据）:

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

Admin API 请求（更新推荐理由）:

-H "Authorization: Bearer $BESTBLOGS_ADMIN_JWT_TOKEN"
-H "User-Id: $BESTBLOGS_ADMIN_USER_ID"
-H "Content-Type: application/json"

若必要的环境变量未设置，提示用户配置。Admin 环境变量仅在用户选择更新推荐理由时才需要。

接口地址：https://api.bestblogs.dev

工作流

第一步：解析输入，提取内容 ID

用户输入格式：

从 URL 中提取最后一段路径作为 ID。

第二步：并行获取内容数据

同时发起两个请求：

# 获取元数据（标题、摘要、观点、金句、标签等）
curl -s "https://api.bestblogs.dev/openapi/v1/resource/meta?id={ID}" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY"

# 获取 Markdown 正文
curl -s "https://api.bestblogs.dev/openapi/v1/resource/markdown?id={ID}" \
  -H "X-API-KEY: $BESTBLOGS_API_KEY"

若 meta 接口返回错误或 success: false，提示用户检查 ID 是否正确。markdown 接口返回 null 时，仅基于 meta 数据生成推荐语。

第三步：分析内容

从获取的数据中提取关键信息：

从 meta 数据中获取:

从 Markdown 正文中获取:

分析要点:

第四步：识别内容领域和类型

根据 category 和 type 调整推荐语风格。详细的领域和类型指导见 references/examples_and_guidelines.md。

内容领域:

内容类型:

第五步：撰写两个版本的推荐语

版本一：推荐版本（Standard）

版本二：精炼简洁版本（Concise）

第六步：质量检查

撰写完成后，逐条检查：

内容准确性:

语言质量（详细规范见 references/writing_standards.md）:

术语处理（详细规范见 references/terminology_guidelines.md）:

版本差异化:

第七步：用户确认与更新推荐理由

输出两个版本后，询问用户是否需要更新该内容的推荐理由：

更新推荐理由 — 写操作，必须在用户明确确认后才能调用：

curl -s -X POST https://api.bestblogs.dev/api/admin/article/updateFeaturedReason \
  -H "Authorization: Bearer $BESTBLOGS_ADMIN_JWT_TOKEN" \
  -H "User-Id: $BESTBLOGS_ADMIN_USER_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "{RESOURCE_ID}",
    "zhFeaturedReason": "中文推荐语",
    "enFeaturedReason": "English recommendation"
  }'

其中 id 使用第一步解析出的内容 ID，zhFeaturedReason 和 enFeaturedReason 使用用户选择的版本对应的中英文推荐语。

更新成功后告知用户。若失败，检查 admin 环境变量是否已配置。

输出模板

## 版本一：推荐版本

### 中文

[推荐语正文]

### English

[Recommendation text]

---

## 版本二：精炼简洁版本

### 中文

[推荐语正文]

### English

[Recommendation text]

输出推荐语后，附加提示：

---
是否需要更新该内容的推荐理由？请选择：
- **1** — 使用版本一更新
- **2** — 使用版本二更新
- **跳过** — 不更新

写作核心原则

推荐语的目的是帮助读者快速判断一篇内容是否值得投入时间阅读，会作为精选周刊的描述内容展示。因此需要：

避免的写法:

批量处理

当用户提供多个 ID 或链接时：

错误处理

OpenAPI 接口:

Admin API 接口: