Wechat Article Extractor
Turn WeChat Official Account article links into structured metadata and HTML for competitive research, clipping, or downstream content workflows.
Overview
WeChat Article Extractor is an agent skill for the Idea phase that parses WeChat Official Account URLs and returns structured article and account metadata plus optional HTML content.
Install
npx skills add https://github.com/freestylefly/wechat-article-extractor-skill --skill wechat-article-extractorWhat is this skill?
- Parses mp.weixin.qq.com article URLs and optional raw HTML inputs
- Returns title, author, description, publish time, cover image, and account profile fields
- Fetches full article HTML with toggles for raw meta via shouldReturnContent and shouldReturnRawMeta
- Handles post, video, image, voice, text, and repost article types
- Surfaces deleted, expired, and access-limit failures instead of silent partial data
- Supports six article types: post, video, image, voice, text, and repost
Adoption & trust: 3.3k installs on skills.sh; 52 GitHub stars; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have mp.weixin.qq.com links or saved HTML but no reliable way to pull title, author, timing, cover art, and body into JSON your agent can reuse.
Who is it for?
Builders doing Chinese-market or WeChat-native competitor and content research who want repeatable structured extraction from official article URLs.
Skip if: Sites outside WeChat Official Account articles, workflows that cannot use network fetch, or cases where you only need a one-off screenshot with no structured fields.
When should I use this skill?
User needs to parse WeChat article URLs (mp.weixin.qq.com), extract article info (title, author, content, publish time, cover image), or convert WeChat articles to structured data.
What do I get? / Deliverables
You get a normalized extract result (done, code, data) suitable for research notes, archives, or the next summarization or translation step in your pipeline.
- Structured extract payload with done, code, and data (metadata, account info, optional HTML)
Recommended Skills
Journey fit
Solo builders often mine WeChat posts for market signals and competitor messaging before they commit to a product direction—canonical shelf is early research, not shipping. Subphase research is where URL-to-structured-data extraction supports competitor scans, audience language mining, and source archiving from mp.weixin.qq.com.
How it compares
Use instead of manual copy-paste from WeChat in-app browsers when you need machine-readable metadata and HTML for agent workflows.
Common Questions / FAQ
Who is wechat-article-extractor for?
Solo and indie builders and agents that research markets or competitors using WeChat Official Account articles and need structured title, author, time, cover, and content fields from mp.weixin.qq.com URLs.
When should I use wechat-article-extractor?
Use it during Idea research when parsing article URLs, converting WeChat posts to structured data, or handling post, video, image, voice, and repost article types—including when links may be deleted or rate-limited.
Is wechat-article-extractor safe to install?
It implies fetching third-party URLs and running a Node script; review the Security Audits panel on this page and inspect scripts/extract.js and network behavior before running on sensitive machines.
SKILL.md
READMESKILL.md - Wechat Article Extractor
# WeChat Article Extractor Extract metadata and content from WeChat Official Account (微信公众号) articles. ## Capabilities - Parse WeChat article URLs (`mp.weixin.qq.com`) - Extract article metadata: title, author, description, publish time - Extract account info: name, avatar, alias, description - Get article content (HTML) - Get cover image URL - Support multiple article types: post, video, image, voice, text, repost - Handle various error cases: deleted content, expired links, access limits ## Usage ### Basic Extraction from URL ```javascript 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 ```javascript const html = await fetch(url).then(r => r.text()); const result = await extract(html, { url: sourceUrl }); ``` ### Options ```javascript 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 ```javascript { 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 ```javascript { 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: - `cheerio` - HTML parsing - `dayjs` - Date formatting - `request-promise` - HTTP requests - `qs` - Query string parsing - `lodash.unescape` - HTML entities ## Notes - Handles various WeChat page structures and anti-scraping measures - Automatically detects article ty