API 参考

完整 API 文档见 references/api.md，包含所有接口的请求/响应格式。

选择规律记忆

Agent 的学习规律存储在技能文件路径下 references/agent-rules.md，每次学习后更新此文件。

执行流程

流程一：学习选择规律(可选)

先读取文件references/agent-rules.md文档，如果包含内容筛选规律则使用此规律作为后续任务的选择标准，跳过此步骤；无可参考的规律内容时按顺序执行：

1. 调用 GET /api/news/agent-summary 获取学习数据
2. 分析数据：
   • saved_news：用户推送过的资讯（含 push_type）
   • all_news_in_period：对应时段所有资讯
   • 对比两个列表，提炼被选中资讯的共同特征
3. 将分析的规律追加到 references/agent-rules.md中

分析角度 ：

• 被选中资讯的来源分布（哪些信源更受偏好）
• 被选中资讯的主题特征（关键词、话题类型）
• 推送类型分布（用户倾向于哪类推送）
• 内容创作选题特征（哪类话题被创作）

流程二：资讯推送

To execute the news push workflow:

1. 调用 POST /api/news/fetch 拉取最新资讯
2. 调用 GET /api/news/grouped?agent=1 获取资讯列表（已推送条目自动排除，无需手动去重）
3. 使用 references/agent-rules.md 中的筛选规律
4. 根据规律从列表中筛选 0-5 条有价值的资讯（无有价值资讯可直接结束此流程）
5. 对每条资讯：

   • 判断推送类型（ainews / aitopics / aitools）

   • 生成 news_title（≤30字，精炼有力）和 news_summary（100-200字，符合对应风格）

   • 调用对应推送接口（注意：接口路径为 /api/news/{id}/ainews 等，不是 /{id}/ainews/）：

     POST /api/news/{id}/ainews
     POST /api/news/{id}/aitopics
     POST /api/news/{id}/aitools
     

   • 请求体示例：{"news_title":"标题","news_summary":"摘要内容"}

6. 完成后调用 POST /api/content/notify-bot 通知人类

推送类型判断原则 ：

• ainews：客观事实类资讯，速报风格
• aitopics：有争议或引人思考的话题，末尾加引导性问题
• aitools：新工具/新产品发布，突出功能和使用场景

流程三：内容创作

To execute the content creation workflow:

1. 从资讯列表选定 0-3 条适合内容创作的资讯（通常是有深度或有趣的话题，无有价值资讯可直接结束此流程）

2. 对每条资讯，构造以下参数并调用 POST /api/content/agent-render：

   • news_id：资讯 ID
   • source_url：原始链接（description中的链接，不是资讯的链接；有则填，服务会自动截图）
   • cover_word：1-2个英文单词，概括核心主题
   • cover_title：≤15字，有冲击力的中文标题
   • cover_description：≤20字，补充说明
   • cover_emoji：1个相关 Emoji
   • content_type：news/tools/topics/default（决定配色）
   • title：≤20字，小红书风格标题
   • content：正文，500-800字，小红书风格，有观点有情感
   • tags：3-5个标签，逗号分隔

3. 获取渲染结果的 saved_content_id、cover_url、detail_urls

4. （可选，未明确则跳过）调用 POST /api/content/save-to-bitable 存入飞书多维表（传 saved_content_id）

5. 调用 POST /api/content/publish-xhs将笔记内容发布到小红书：

   {
     "title": "{title（≤20字）}",
     "desc": "{content}",
     "cover_url": "{cover_url}",
     "detail_urls": ["{detail_urls[0]}", "..."],
     "is_private": true
   }
   

   • Agent 必须传"is_private": true，笔记将以「仅自己可见」发布，由人类在小红书 App 中审核后手动设为公开
   • 成功后从响应中取 note_url
   • 若接口返回错误"小红书发布功能未开启"，不重试、不报错 ，跳过此步骤即可

6. 调用 POST /api/content/notify-bot 发送通知，消息格式：

   ✅ 内容创作完成
   
   标题：{title}
   类型：{content_type}
   标签：{tags}
   
   已存入飞书多维表，请审核。
   {如已发布到小红书：🔗 小红书笔记（仅自己可见，请在 App 审核后设为公开）：{note_url}}
   

注意事项

• 截图详情图可能因目标网站防爬而失败，失败时静默跳过，只生成封面
• 推送接口会自动标记资讯为已保存，无需手动调用 save 接口
• Agent 生成内容时，news_title 和 news_summary 直接作为推送内容，需保证质量
• 每次执行完整流程后，建议执行一次学习流程以更新规律记忆
• 小红书发布 ：发布开关默认关闭，由人类决定是否授权。Agent 应尊重此开关，收到"未开启"错误时静默跳过，不得反复重试或提示人类开启
• 服务不可用 ：调用 API 前建议先 GET /api/health。若请求返回 5xx 错误，可能是服务临时故障，可等待数秒后重试一次；若仍失败则终止流程并通知人类

Weekly Installs

1

Repository

comeonzhj/autocontents

GitHub Stars

149

First Seen

Today

Security Audits

Gen Agent Trust HubFailSocketPassSnykWarn

Installed on

amp1

cline1

openclaw1

opencode1

cursor1

kimi-cli1