【爆款兔-增势智能科技】微信公众号文章拆解

概述

Popto 文章结构分析

使用 [scripts/analyze_wechat_article.py](scripts/analyze_wechat_article.py) 调用 Popto OpenAPI，提交文章拆解任务、轮询结果并交付 Markdown 报告。接口字段见 [references/api.md](references/api.md)。

执行前准备

1. 在技能目录的 config.json 配置 BASE_URL 和 POPTO_API_KEY。地址默认 https://popto.cn，密钥没有默认值。不要打印或编造密钥。
2. 密钥缺失时，引导用户在所选服务环境的 API 密钥页面（BASE_URL + /workspace/api）创建，并写入配置文件或设置环境变量 POPTO_API_KEY。
3. 地址优先级：--base-url → 环境变量 POPTO_BASE_URL → BASE_URL → 配置文件 BASE_URL → 默认值。密钥优先级：--api-key → 环境变量 POPTO_API_KEY → POPTO_API_TOKEN（兼容）→ 配置文件 POPTO_API_KEY。空值跳过；恢复任务时沿用原服务地址和账号。
4. 新任务会消耗积分。运行前先确认：默认预计 5 点；公众号文章开启 --fetch-stats 时预计 7 点。公开网页和文档始终关闭统计，不收取统计附加积分。实际以免费权益和线上计费配置为准。使用 --task-id 恢复不重复扣费，无需再次确认。

输入要求

单次只处理一个输入：公开网页或公众号文章链接、--file 本地文档、--file-url 公开文档地址，三者不能同时提供。网页链接必须是 HTTP(S)，优先支持无需登录即可读取正文的博客、文档站和新闻文章。公众号文章仍支持 /s/分享码 及 /s?__biz=...&mid=...&idx=...&sn=... 两种格式。可从分享文本或 Markdown 中提取链接，清理 _、& 等复制转义；完整保留签名、查询参数和片段，不重新编码 URL 或截断为 /s。

网页由服务端静态抓取、提取正文、转换为 Markdown 并清洗导航、相关文章和评论，再送入结构分析。脚本只调用 Popto OpenAPI，不直接调用 Cloudflare；服务端不执行网页 JavaScript。需要登录、依赖 JavaScript 加载正文或被站点拦截的页面可能提取失败，此时展示失败原因，可改用参考文档上传，不重复新建同一任务。

文档单个文件最大 50MB，支持以下扩展名：.pdf、.doc、.docx、.rtf、.ppt、.pptx、.xls、.xlsx、.csv、.tsv、.odt、.ods、.odp、.epub、.html、.htm、.shtml、.mhtml、.mht、.ofd。本地文件必须非空；远程文档地址必须是 HTTP(S) 地址并带有上述扩展名。不接受公众号主页、微信视频号或其他类型文件。

运行

新建任务：

python3 scripts/analyze_wechat_article.py "https://mp.weixin.qq.com/s/..."
python3 scripts/analyze_wechat_article.py "https://example.com/blog/article?ref=share#content"

分析本地文档或公开文档地址：

python3 scripts/analyze_wechat_article.py --file ./reference.pdf
python3 scripts/analyze_wechat_article.py --file-url "https://cdn.example/reference.docx"

可选参数：

• --config PATH：指定配置文件，默认使用本技能目录的 config.json。
• --base-url URL：覆盖服务地址；填写 HTTP(S) 基础地址，脚本自动追加 API 路径。
• --fetch-stats：仅对公众号文章额外获取阅读、点赞、分享、收藏、评论等真实统计数据，通常额外消耗 2 点。公开网页和文档即使传入此参数也会强制关闭统计。统计接口不可用会使任务失败，因此仅在用户明确需要公众号统计时开启。
• --file PATH：上传并分析一个本地参考文档，最大 50MB；上传成功后使用同一文章分析异步任务转换和分析。
• --file-url URL：分析一个已经可以公开访问的文档 URL；URL 必须是 HTTP(S) 且带支持的文档扩展名。
• --out PATH：报告文件或目录；默认生成 wechat_article_<task_id>.md。
• --interval SECONDS：轮询间隔，默认 4 秒。
• --max-wait SECONDS：最长等待时间，默认 900 秒。
• --task-id ID：恢复已有任务，不得与新链接同时使用。

本地文档先通过 POST /api/open/v1/toolbox/wechat_article_analysis/upload 上传，再向 POST /api/open/v1/toolbox/wechat_article_analysis 提交 file_url、file_name 和 mime_type；公开文档 URL 直接提交这三个字段。服务端通过 aiiprpc DocumentService 将 PDF、DOCX、PPT 等文件转换成 Markdown，文档中的图片会上传 CDN 并替换 Markdown 图片地址，供报告和前端 Markdown 预览使用。文档输入不支持公众号互动统计，脚本会强制 fetch_stats=false，也不会为统计额外扣点。

所有来源都通过 POST /api/open/v1/toolbox/wechat_article_analysis 提交：公众号链接使用 wechat_url，公开网页使用 url 且 fetch_stats=false，文档使用 file_url。再通过 POST /api/open/v1/task/batch_get 轮询。成功后将任务 outputs 的扁平结构化结果渲染为报告；字段缺失时如实省略，不补造数据。公开网页没有公众号互动统计；文档结果的原文部分标题为“文档 Markdown 内容”。

成功输出标记：

POPTO_WECHAT_TOOL_ID=<tool_id>
POPTO_WECHAT_TASK_ID=<task_id>
POPTO_WECHAT_SOURCE_URL=<outputs.source_url；缺失时省略>
POPTO_WECHAT_REPORT_FILE=<absolute path>
POPTO_WECHAT_DISPLAY_URL=<BASE_URL>/workspace/toolbox/wechat_article_analysis?tool_id=<tool_id>
=== POPTO_WECHAT_REPORT_START ===
<Markdown report>
=== POPTO_WECHAT_REPORT_END ===

成功后优先交付完整报告、保存路径和展示页。接口不返回实际扣点，只能说明预计值，以账户账单为准。

失败与恢复

网络短暂错误由脚本有限重试。报告文件写入失败但 stdout 已有报告时，仍交付对话报告并说明未保存。