# WeChat Official Account Scraper (No Login) - 公众号 Articles (`headply/wechat-article-scraper`) Actor

Scrape WeChat Official Account (公众号) articles without a WeChat account: search by keyword or account name, or paste article links, and get the full article text, images, publish time and region, plus the account's WeChat ID and description. 'Only new' mode for daily monitoring.

- **URL**: https://apify.com/headply/wechat-article-scraper.md
- **Developed by:** [Mayowa Ogedengbe](https://apify.com/headply) (community)
- **Categories:** Social media, News, AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 41.2% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.75 / 1,000 articles

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## WeChat Official Account Scraper (公众号文章) — full article text, no login

Get WeChat Official Account (微信公众号) articles as clean data, **without a WeChat account, login or cookies**.
Search by keyword, follow accounts by name, or paste article links, and every article comes back with its **full
text**, images, publish time, publishing region, original (原创) badge and the account behind it: name, WeChat ID,
original ID (gh\_…) and description.

Built for China market research, brand and competitor monitoring, media monitoring, and Chinese-language datasets
for AI. Schedule it daily with **Only new articles** and each run returns just what appeared since the last one.

### What you get

| Field | Example (real run, 5 Nov 2026) |
|---|---|
| `title` | 大模型赋能网络安全：机遇与挑战 |
| `accountName` / `accountWechatId` / `accountId` | 理论动态 / lilundt / gh_51daf2cdbc11 |
| `author` | 何卓丰 等 |
| `publishedAt` | 2026-11-05T19:53:14+08:00 |
| `region` | 北京 (the "发表于" location WeChat shows) |
| `isOriginal` | false (true when the article carries the 原创 badge) |
| `articleType` | article (or image post) |
| `characterCount` / `imageCount` | 11401 / 2 |
| `contentText` | 网络安全是国家安全与社会稳定的重要保障，网络安全大模型为安全攻防体系智能化提供了重要支撑。… |
| `digest`, `coverImage`, `images`, `hashtags` | summary, cover picture, every image in the article, #topics |
| `accountDescription`, `accountAvatar`, `accountOwner` | the account's bio, avatar and (when WeChat shows it) the registered organisation |
| `articleKey` | MjM5OTgyODEwNQ==:2650809922:1 (a permanent ID for the article) |

Optional: `contentHtml` with the article body as HTML. Every field is always present (null when WeChat doesn't
show it), so your spreadsheets and pipelines never break.

In a 125-article test (5 keywords and accounts, 5 Nov 2026) every article came with full text, account name,
original ID, publish time and cover. Coverage of the optional fields: account WeChat ID 79%, region 74%, author 56%
(many accounts don't name one), registered organisation 21%. The median article had 1,938 characters.

### How to use it

1. **Keywords**: what to search for, one per line. Chinese keywords find the most (新能源汽车, 跨境电商, 咖啡);
   English brand names work too.
2. **Official Account names**: the account name exactly as WeChat shows it (e.g. 36氪, 新华社).
3. **Article links**: WeChat article links you already have, in the short form `https://mp.weixin.qq.com/s/…`
   (in WeChat: open the article → ⋯ → Copy Link).
4. Choose **Max articles per keyword or account** (up to 100) and press **Start**.

The defaults return the full text. Turn **Full article text** off when you only need the list (title, summary,
account, date, link): it is faster and cheaper.

#### Input examples

Watch three topics every morning (save as a Task and add a daily Schedule):

```json
{
  "keywords": ["新能源汽车", "跨境电商", "人工智能"],
  "maxArticlesPerSearch": 50,
  "publishedWithin": "week",
  "onlyNew": true,
  "monitorName": "china-topics-daily"
}
```

Articles from named accounts:

```json
{ "accounts": ["36氪", "新华社"], "maxArticlesPerSearch": 30 }
```

Articles you already have:

```json
{ "articleUrls": ["https://mp.weixin.qq.com/s/_2kC-fXw7UjneZSrsC9CVQ"], "includeHtml": true }
```

An empty input runs a small live sample (keyword 人工智能, 5 articles) so you can see the output first.

### Pricing

Pay only for what you get:

| Event | Price per 1,000 (Free plan → Gold) |
|---|---|
| Article with full text | $2.50 → $1.75 |
| Article, search data only (full text off) | $1.00 |
| Run start | $0.001 per run |

**Example:** 3 keywords × 50 articles with full text every day = 150 articles/day ≈ **$0.38 a day** on the Free
plan. With **Only new articles** on, repeat articles are skipped and not billed, so a daily monitor usually costs
less after the first run.

Never billed: duplicates, articles already delivered to the same monitor, links that can't be read. Set a maximum
cost per run in the run options and the run stops cleanly when it is reached. Apify's free plan returns up to 10
articles per run; any paid plan removes the limit.

### Daily monitoring (only new articles)

Turn on **Only new articles** and give the schedule a **Monitor name**. The first run returns up to your maximum;
every later run returns only articles this monitor has not returned before. Use a different monitor name for each
schedule. Combine with **Published within: Last 24 hours** for a daily digest of fresh articles.

### Use it from code or n8n

```bash
curl -X POST "https://api.apify.com/v2/acts/headply~wechat-article-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["新能源汽车"], "maxArticlesPerSearch": 20}'
```

In **n8n**, add the Apify node → *Run an Actor and get dataset*, choose `headply/wechat-article-scraper` and paste
the input JSON. Each article becomes one n8n item, ready for an AI summary, a translation step, Slack, Notion or a
Google Sheet. The dataset also has ready-made views: **Articles**, **Full text** and **Accounts**.

### Good to know (honest limits)

- **Account names return the account's articles that WeChat search can find**, most relevant first (so publish
  dates are mixed: add **Published within** for recent ones only), not the account's complete archive. Popular
  accounts return plenty; very small accounts may return few.
- **Read and like counts are not included.** WeChat only shows them inside the WeChat app.
- **Article links:** use the short form `https://mp.weixin.qq.com/s/…`. Long links (`…/s?__biz=…&sn=…`) are often
  refused by WeChat outside the app; the run says so and they are not billed.
- **The `url` of a search result is a temporary link** that works for some hours. Use `articleKey` as the permanent
  identity of an article, and `contentText` to keep the article itself.
- A keyword returns up to about 100 articles. Split broad topics into several keywords for more.
- Deleted or removed articles come back with `status` (`deleted`, `removed`, `migrated`) and the search data, billed
  as search data only.

### FAQ

**Do I need a WeChat account?** No. Nothing to log in to and no cookies to supply.

**Can I scrape in English?** Yes, but most Official Accounts publish in Chinese, so Chinese keywords return far
more. The text comes back in the original language; add a translation step in n8n or your code.

**How fresh are the results?** Brand-new articles usually appear within hours. Use **Published within** to keep only
recent ones.

**Is the output stable for pipelines?** Yes. Fields are never renamed or removed, and every field is always present.

### More China data from the same developer

- [Bilibili Scraper](https://apify.com/headply/bilibili-scraper): videos and creators from Bilibili.
- [Bilibili Danmaku Scraper](https://apify.com/headply/bilibili-danmaku-scraper): the bullet comments on any Bilibili video.
- [1688 Scraper](https://apify.com/headply/1688-scraper): wholesale prices, MOQ and suppliers from 1688.com.
- [TikTok Shop Scraper](https://apify.com/headply/tiktok-shop-scraper): products, sales and stock in 10 countries.

# Actor input Schema

## `keywords` (type: `array`):

Search WeChat articles, one keyword per line. Chinese keywords find the most (e.g. 新能源汽车); English works too.

## `accounts` (type: `array`):

Articles of these accounts, by the account name exactly as WeChat shows it (e.g. 36氪). Returns the account's articles found in WeChat search, not its complete history.

## `articleUrls` (type: `array`):

WeChat article links to read in full. Use the short form https://mp.weixin.qq.com/s/… (in WeChat: ⋯ → Copy Link).

## `maxArticlesPerSearch` (type: `integer`):

WeChat search shows up to about 100 articles for one keyword.

## `includeContent` (type: `boolean`):

On: every article is opened for the full text, images, author, region, original badge and account details. Off: search data only (title, summary, account, date, link), cheaper and faster.

## `includeHtml` (type: `boolean`):

Adds the article body as HTML (contentHtml) next to the plain text.

## `publishedWithin` (type: `string`):

Skip older articles.

## `onlyNew` (type: `boolean`):

Return only articles this monitor has not returned before. Articles already delivered are skipped and not billed.

## `monitorName` (type: `string`):

Keeps separate memories for different schedules (e.g. 'ev-news-daily').

## `selfTest` (type: `boolean`):

Fail the run when nothing is delivered (health checks).

## Actor input object example

```json
{
  "keywords": [
    "新能源汽车",
    "跨境电商"
  ],
  "maxArticlesPerSearch": 10,
  "includeContent": true,
  "includeHtml": false,
  "publishedWithin": "any",
  "onlyNew": false,
  "monitorName": "default",
  "selfTest": false
}
```

# Actor output Schema

## `articles` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "新能源汽车",
        "跨境电商"
    ],
    "maxArticlesPerSearch": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("headply/wechat-article-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": [
        "新能源汽车",
        "跨境电商",
    ],
    "maxArticlesPerSearch": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("headply/wechat-article-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "新能源汽车",
    "跨境电商"
  ],
  "maxArticlesPerSearch": 10
}' |
apify call headply/wechat-article-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,headply/wechat-article-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/emCkB3YCXViOdy1IM/builds/nKm1X4qDSH6F4MAlz/openapi.json
