Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
freestylefly avatar

Wechat Article Extractor

  • 3.7k installs
  • 112 repo stars
  • Updated February 19, 2026
  • freestylefly/wechat-article-extractor-skill

Parsed WeChat article metadata and HTML content in structured JSON format with account identifiers.

About

WeChat Article Extractor parses mp.weixin.qq.com URLs and HTML to extract article metadata (title, author, publish time, cover image), account information (name, avatar, alias), and HTML content from WeChat Official Account posts. Developers use it to integrate WeChat content into data collection workflows, convert articles to structured formats, and handle error cases including deleted content, expired links, rate limits, and account migrations. The tool supports multiple article types (post, video, image, voice, text, repost) and provides configurable options for content extraction depth, link following, tag extraction, and repost metadata inclusion. Response data includes account identifiers, article links, and raw metadata when needed. Extract article metadata: title, author, description, publish time, cover image from WeChat URLs. Parse account info: name, avatar, alias, description, biz ID, QR code from Official Accounts. Support multiple article types: post, video, image, voice, text, repost with type detection.

  • Extract article metadata: title, author, description, publish time, cover image from WeChat URLs
  • Parse account info: name, avatar, alias, description, biz ID, QR code from Official Accounts
  • Support multiple article types: post, video, image, voice, text, repost with type detection
  • Handle 16+ error cases: deleted content, expired links, rate limiting, account migration, copyright blocks
  • Return structured response with account data, article content (HTML), link parameters, and publish timestamps

Wechat Article Extractor by the numbers

  • 3,671 all-time installs (skills.sh)
  • +29 installs in the week ending Aug 2, 2026 (Skillselion tracking)
  • Ranked #166 of 4,348 Backend & APIs skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Aug 2, 2026 (Skillselion catalog sync)
At a glance

wechat-article-extractor capabilities & compatibility

Capabilities
parse wechat article urls and extract metadata · extract account information from official accoun · handle article type detection and routing · follow account migration links · extract embedded mp.weixin links within articles · return structured json with 20+ fields · handle rate limiting and access restrictions
Use cases
web scraping · data analysis · documentation · orchestration
Runs
Runs locally
Pricing
Free
npx skills add https://github.com/freestylefly/wechat-article-extractor-skill --skill wechat-article-extractor

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs3.7k
repo stars112
Security audit1 / 3 scanners passed
Last updatedFebruary 19, 2026
Repositoryfreestylefly/wechat-article-extractor-skill

What it does

Parse WeChat Official Account article URLs to extract metadata, content, and account information for integration into data pipelines.

Who is it for?

Content aggregation, data pipelines, research automation, cross-platform publishing workflows, WeChat data archival.

Skip if: Real-time notifications, user-facing WeChat clients, bypassing WeChat security restrictions.

When should I use this skill?

User provides WeChat article URL or HTML and needs structured extraction, or building content ingestion workflows.

What you get

Structured article data (metadata, content, account info) ready for database storage, search indexing, or downstream processing.

  • Structured article JSON
  • Account metadata object

By the numbers

  • Supports 6 article types: post, video, image, voice, text, repost
  • Handles 16 specific error codes covering access, deletion, rate limits, and account states
  • Returns 20+ fields per article including account ID, biz parameter, raw metadata options

Files

SKILL.mdMarkdownGitHub ↗

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

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 });

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

CodeMessageDescription
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 type from page content
  • Supports extracting from Sogou WeChat search results (weixin.sogou.com)
  • Some fields may be null depending on article type and page structure

Related skills

Forks & variants (2)

Wechat Article Extractor has 2 known copies in the catalog totaling 142 installs. They canonicalize to this original listing.

How it compares

Choose wechat-article-extractor over generic web-fetch skills when the source is specifically mp.weixin.qq.com Official Account content with Chinese platform field semantics.

FAQ

What WeChat URL formats are supported?

Supports mp.weixin.qq.com article URLs (standard format) and Sogou WeChat search results (weixin.sogou.com). Requires valid __biz parameter and message ID.

How are error cases like deleted or blocked content handled?

Tool returns specific error codes (e.g. 2005 for deleted, 2006 for blocked, 2002 for expired) and done:false flag. Caller can log, retry, or skip based on code.

Can I extract reposts or only original articles?

Supports repost articles (msg_type: 'repost'). Use shouldExtractRepostMeta option to extract original source information from reposts.

Is Wechat Article Extractor safe to install?

skills.sh reports 1 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

Backend & APIspipelinesetl

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.