> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 怎样定时找公众号新文章，只把选中的链接导入 ima？

> 从公众号目录发现新增文章，按链接导入指定 ima 知识库，并逐条核对入库结果。

手上已有一篇公众号链接，直接用 ima Skill 的 `import_urls` 操作导入指定知识库。要每周追十个公众号，先用 BeatAPI 的 `wechat_mp.v2.fetch_account_articles` 查新，筛出跟项目有关的文章，再用 `import_urls` 把选中的链接交给 ima。先拿一篇文章试导到「行业研究」里的测试文件夹。

## 生成待导入列表

1. 从一个确认过的公众号 `username` 试起。
2. 在调度器添加 HTTP 步骤，使用调度器凭据中的 `Authorization: Bearer <BEATAPI_API_KEY>` 和 `Content-Type: application/json`，POST `https://api.beatapi.io/v1/social-data/call`。第一次只建立基线；要回填旧文章，单独确定历史范围。

```json
{"action":"wechat_mp.v2.fetch_account_articles","params":{"username":"<verified_username>","offset":"","item_show_type":0,"raw":false}}
```

3. 成功后从 `data.articles` 取每篇文章的 URL、标题、`app_msg_id` 和 `idx`。用账号与文章键去重，保留原有导入状态。本轮页数和游标停止条件按[增量流程](/zh/guides/wechat-incremental-articles)设置。
4. 每条待导入记录保留 `article_key`、`article_url`、`destination`、`status` 与 BeatAPI 请求号。已经导入同一目标的记录跳过。同一篇文章要放进两个库时，每个目标单独建一条记录。

## 导入指定知识库

1. 在 ima 新建或选定测试知识库，先在 ima 客户端导入一个网页链接，核对条目进了正确的知识库。
2. 自动流程从 [ima 官方接入页](https://ima.qq.com/agent-interface)安装官方 Skill，按安装版的说明配置 Client ID 与 API Key。ima 凭据和 BeatAPI 密钥分开保存。
3. 用 Skill 按名称搜索知识库，核对库名和知识库 ID。导入子文件夹时另取文件夹 ID。
4. 调用已安装 Skill 的 `import_urls` 操作，传下方参数。先跑一条，跑通后再按 Skill 说明的上限分批。导入根目录时省略 `folder_id`。

```json
{"knowledge_base_id":"<knowledge_base_id>","folder_id":"<folder_id>","urls":["https://mp.weixin.qq.com/s/example"]}
```

## 怎么确认每一篇都进去了？

1. 按 URL 核对结果：`ret_code` 为 0 且有 `media_id` 的 URL 记为已接收。
2. 到目标文件夹找到对应条目，核对原文链接和可读内容。复查无误后记为已入库，并把结果与文章键一起留在清单里。
3. 部分失败时，只逐条重试失败的 URL。
4. 请求超时、结果未知时，先在目标文件夹查找同一链接，再决定是否重发。
5. 条目已出现但还读不到正文时，记为待核。

例如这次找到三篇文章，编辑选了两篇。第一篇返回了 `media_id`，而且能在目标文件夹打开，记「已入库」。第二篇请求超时，先到目标文件夹查第二篇的原文链接：找到条目就核对内容，没找到再用原链接补跑。第三篇没有入选，留在候选清单。下次重跑从候选清单继续，已入库的第一篇直接跳过。项目组还要把第一篇放进另一个库时，为另一个库新建一条待导入记录，沿用原链接和文章键。

安排定时前，用一篇能打开的文章和一次重复输入确认流程。每周查 10 个号、每个号只查一页，四周共 40 次列表请求。只把链接交给 ima 导入时，BeatAPI 用量按实际请求的列表页计算。需要自己保留文章文字，另按[正文读取](/zh/guides/read-wechat-article)取入选文章。两类 BeatAPI 请求的单价见 [BeatAPI 价格页](https://beatapi.io/zh/pricing)，ima 侧用量按 ima 自己的规则核对。

[ima 官方接入页](https://ima.qq.com/agent-interface) · [腾讯云的 ima Skill 安装说明](https://cloud.tencent.com/document/product/248/139217)