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

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 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