微信公众号内容提取工具

WeChat Article Extractor

Extract metadata and content from WeChat Official Account (微信公众号) articles.

Quick Start 🚀

Command Line Usage (Recommended)

The easiest way to use this skill is via the CLI command:

# Basic usage - extracts and saves as markdown
npx wechat-article-extractor https://mp.weixin.qq.com/s/xxx
Specify output path
npx wechat-article-extractor https://mp.weixin.qq.com/s/xxx --output ./articles/post.md
Output JSON format
npx wechat-article-extractor https://mp.weixin.qq.com/s/xxx --json
Show help
npx wechat-article-extractor --help

Programmatic Usage

const { extract } = require('./scripts/extract.js');
const result = await extract('https://mp.weixin.qq.com/s?__biz=...');
if (result.done) {
  console.log(result.data.msg_title);
  console.log(result.data.msg_content);
}

Capabilities

CLI Options

| Option | Description | Default | |--------|-------------|---------| | | WeChat article URL | Required | | --output | Output file path | ./wechat-article.md | | --format | Output format (markdown\|json\|html) | markdown | | --json | Output JSON format | false | | -h, --help | Show help | - |

Examples

# Extract article and save to custom location
npx wechat-article-extractor https://mp.weixin.qq.com/s/xxx --output ./my-article.md
Get JSON output for processing
npx wechat-article-extractor https://mp.weixin.qq.com/s/xxx --json > article.json
From within the skill directory
npm run extract https://mp.weixin.qq.com/s/xxx

Usage in Scripts

Basic Extraction from URL

const { extract } = require('./scripts/extract.js');
const result = await extract('https://mp.weixin.qq.com/s?__biz=...');
// Returns: { done: true, code: 0, data: {...} }

Extraction from HTML

const html = await fetch(url).then(r => r.text());
const result = await extract(html, { url: sourceUrl });

Advanced Options

const result = await extract(url, {
  shouldReturnContent: true,      // Return HTML content (default: true)
  shouldReturnRawMeta: false,     // Return raw metadata (default: false)
  shouldFollowTransferLink: true, // Follow migrated account links (default: true)
  shouldExtractMpLinks: false,    // Extract embedded mp.weixin links (default: false)
  shouldExtractTags: false,       // Extract article tags (default: false)
  shouldExtractRepostMeta: false  // Extract repost source info (default: false)
});

Response Format

Success Response

{
  done: true,
  code: 0,
  data: {
    // Account info
    account_name: "公众号名称",
    account_alias: "微信号",
    account_avatar: "头像URL",
    account_description: "功能介绍",
    account_id: "原始ID",
    account_biz: "biz参数",
    account_biz_number: 1234567890,
    account_qr_code: "二维码URL",
    // Article info
    msg_title: "文章标题",
    msg_desc: "文章摘要",
    msg_content: "HTML内容",
    msg_cover: "封面图URL",
    msg_author: "作者",
    msg_type: "post", // post|video|image|voice|text|repost
    msg_has_copyright: true,
    msg_publish_time: Date,
    msg_publish_time_str: "2024/01/15 10:30:00",
    // Link params
    msg_link: "文章链接",
    msg_source_url: "阅读原文链接",
    msg_sn: "sn参数",
    msg_mid: 1234567890,
    msg_idx: 1
  }
}

Error Response

{
  done: false,
  code: 1001,
  msg: "无法获取文章信息"
}

Error Codes

| Code | Message | Description | |------|---------|-------------| | 1000 | 文章获取失败 | General failure | | 1001 | 无法获取文章信息 | Missing title or publish time | | 1002 | 请求失败 | HTTP request failed | | 1003 | 响应为空 | Empty response | | 1004 | 访问过于频繁 | Rate limited | | 1005 | 脚本解析失败 | Script parsing error | | 1006 | 公众号已迁移 | Account migrated | | 2001 | 请提供文章内容或链接 | Missing input | | 2002 | 链接已过期 | Link expired | | 2003 | 内容涉嫌侵权 | Content removed (copyright) | | 2004 | 无法获取迁移后的链接 | Migration link failed | | 2005 | 内容已被发布者删除 | Content deleted by author | | 2006 | 内容因违规无法查看 | Content blocked | | 2007 | 内容发送失败 | Failed to send | | 2008 | 系统出错 | System error | | 2009 | 不支持的链接 | Unsupported URL | | 2010 | 内容获取失败 | Content fetch failed | | 2011 | 涉嫌过度营销 | Marketing/spam content | | 2012 | 账号已被屏蔽 | Account blocked | | 2013 | 账号已自主注销 | Account deleted | | 2014 | 内容被投诉 | Content reported | | 2015 | 账号处于迁移流程中 | Account migrating | | 2016 | 冒名侵权 | Impersonation |

Dependencies

Required npm packages:

Notes

Troubleshooting

"MODULE_NOT_FOUND" error

cd C:\Users\xsl\.agents\skills\wechat-article-extractor
npm run extract 

"访问过于频繁" error

Link expired

# Extract article and save to custom location
npx wechat-article-extractor https://mp.weixin.qq.com/s/xxx --output ./my-article.md
Get JSON output for processing
npx wechat-article-extractor https://mp.weixin.qq.com/s/xxx --json > article.json
From within the skill directory
npm run extract https://mp.weixin.qq.com/s/xxx