# WeChat Official Account Scraper & Competitor Report (`scrupulous_buckler/wechat-ecosystem-data-intelligence`) Actor

Enter one keyword. Get up to 100 public WeChat Official Account articles plus account share, topic gaps, title patterns, new-post signals, and source links. Built-in collection; no login, Cookie, or upstream Actor. $0.0025/article + $0.99/report. No result charges on empty runs.

- **URL**: https://apify.com/scrupulous\_buckler/wechat-ecosystem-data-intelligence.md
- **Developed by:** [Peng Lyu](https://apify.com/scrupulous_buckler) (community)
- **Categories:** Social media, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 wechat official account article results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

Monitor public WeChat Official Account competitors without uploading a WeChat
Cookie. Search public articles through Sogou or analyze article records already
stored in your Apify Datasets.

Enter one brand, competitor, product, or category keyword on the first screen.
The standard live-search path returns up to 100 article rows and one finished
competitor-monitor report. It needs no WeChat login or Cookie.

Live public collection runs inside this Actor. It does not call another public
Actor and does not require the customer's plan to run community Actors. Pricing
is **$0.0025 per delivered article row plus $0.99 per completed report**. A
100-article run has a maximum custom-event charge of **$1.24**. No article or
report event is charged when no usable articles return.

**Unofficial tool. This Actor is not affiliated with, sponsored by, or endorsed
by Tencent, WeChat, Weixin, Sogou, or any source platform.**

### What buyers receive

Every successful report includes up to 100 normalized article rows plus:

- competitor account share and estimated publishing cadence
- new-post detection when a prior snapshot is supplied
- topic coverage and topic-share changes versus the baseline
- common title formats, including list, question, guide, comparison, case, and
  announcement patterns
- topics covered by multiple competitors
- uncovered or weakly covered buyer-supplied topics
- evidence-linked content opportunities and source URLs
- explicit data-quality warnings and collection metadata

The analysis is deterministic and evidence linked. It does not claim to use AI
and does not invent missing article or audience data.

### Ready-made public tasks

Choose the task that matches the result you need. Each task opens with one
visible input and a working example:

- [Monitor WeChat Official Account competitors](https://apify.com/scrupulous_buckler/wechat-ecosystem-data-intelligence/examples/monitor-wechat-official-account-competitors)
- [Find WeChat Official Account topic gaps](https://apify.com/scrupulous_buckler/wechat-ecosystem-data-intelligence/examples/find-wechat-official-account-topic-gaps)
- [Compare WeChat competitor article strategy](https://apify.com/scrupulous_buckler/wechat-ecosystem-data-intelligence/examples/compare-wechat-competitor-article-strategy)
- [Preview the WeChat competitor monitor for free](https://apify.com/scrupulous_buckler/wechat-ecosystem-data-intelligence/examples/preview-wechat-competitor-monitor-free)

### Four source options

#### 1. Preview

Enter `preview` in the required source field. The Actor runs immediately with a
built-in current sample and baseline so you can inspect the report structure.
The preview does not charge the report event.

#### 2. Live public Sogou WeChat search

Enter one brand, competitor, product, or category keyword in the required source
field. The built-in collector searches the public Sogou WeChat article index,
normalizes the returned discovery metadata, and creates the report in the same
run.

No WeChat login or Cookie is requested. Live coverage can still be incomplete,
delayed, blocked, or throttled by Sogou. Apify Proxy is enabled by default and
can be changed under Advanced collection controls.

#### 3. Apify Datasets

Enter `dataset:YOUR_DATASET_ID` in the required source field. Use
`priorDatasetId` in Advanced source options for an earlier snapshot if you want
new-post and topic-shift comparison.

#### 4. Uploaded records

Enter `uploaded` in the required source field, then paste current article JSON
into `uploadedRecords` under Advanced source options. An optional
`baselineRecords` snapshot enables new-post and topic-shift comparison.

### Example live search

```json
{
  "source": "新能源汽车",
  "competitorAccounts": ["品牌甲", "品牌乙"],
  "topicKeywords": ["续航", "安全", "充电", "价格"],
  "lookbackDays": 90,
  "maxResults": 100
}
```

### Example using your own datasets

```json
{
  "source": "dataset:CURRENT_DATASET_ID",
  "priorDatasetId": "PRIOR_DATASET_ID",
  "competitorAccounts": ["竞品公众号A", "竞品公众号B"],
  "topicKeywords": ["用户案例", "价格", "常见问题"],
  "lookbackDays": 90,
  "maxResults": 100
}
```

### Recognized article fields

Common English, Chinese, and Sogou scraper aliases are normalized, including
`articleId`, `title`, `articleTitle`, `snippet`, `summary`, `content`,
`accountName`, `authorName`, `gzh_name`, `publishedAt`, `publishTimestamp`,
`publishDateText`, `articleUrl`, `sogouUrl`, `coverImageUrl`, `keyword`,
`position`, and `page`.

At minimum, each usable record needs a title, snippet, or text field. Article
URLs and account names improve deduplication and comparison quality.

### Pricing

- **$0.0025 per delivered article row**
- **$0.99 per completed competitor content report**
- **Maximum custom-event charge for 100 articles: $1.24**

Empty or unusable input and the illustrative preview do not charge article or
report events. There is no separate public Actor charge. Apify may show its
small platform Actor Start event separately.

### Important limits

- Results describe the collected or uploaded sample, not every WeChat article.
- New-post status and topic changes require an explicit prior Dataset or uploaded
  baseline.
- Public Sogou search can omit, delay, or reorder results.
- Publishing cadence is a sample-window estimate, not a complete account history.
- Topic and title-pattern labels use transparent cue rules and may miss context.
- The Actor does not access subscriber identities, private messages, backend
  analytics, private audience demographics, or WeChat credentials.
- Content opportunities are research signals, not guaranteed performance.

### Responsible use

Only process data you are authorized to use. Follow source-platform terms,
privacy, advertising, intellectual-property, and data-protection requirements.

### Related WeChat research

Need to identify repost chains instead of comparing competitor coverage? Use
[WeChat Article Repost & Original Source Tracker](https://apify.com/scrupulous_buckler/wechat-article-repost-original-source-tracker).

### Local validation

```bash
python3 -m unittest discover -s tests -v
```

# Actor input Schema

## `source` (type: `string`):

Examples: 新能源汽车, 品牌A, AI教育, or 医疗器械. Advanced users can enter dataset:DATASET\_ID or uploaded to use their own records.

## `competitorAccounts` (type: `array`):

Optional exact account names to compare in account-share and publishing-cadence results.

## `topicKeywords` (type: `array`):

Optional audience questions, product attributes, use cases, or category topics.

## `uploadedRecords` (type: `array`):

Set source to uploaded and paste article JSON here. Common English, Chinese, and Sogou scraper field names are recognized.

## `sourceDatasetIds` (type: `array`):

Set source to dataset:DATASET\_ID and select up to ten accessible Datasets containing WeChat article records.

## `priorDatasetId` (type: `string`):

Optional earlier snapshot used to mark new posts and compare topic share.

## `baselineRecords` (type: `array`):

Optional earlier article snapshot for new-post and topic-shift comparison.

## `proxyConfiguration` (type: `object`):

Used only by built-in live public search. No public Actor is invoked.

## `lookbackDays` (type: `integer`):

Articles with a valid date outside this window are excluded.

## `maxResults` (type: `integer`):

Maximum normalized article rows analyzed and delivered in one report.

## `maxEvidence` (type: `integer`):

Maximum evidence-linked article examples in each report section.

## Actor input object example

```json
{
  "source": "新能源汽车",
  "competitorAccounts": [],
  "topicKeywords": [],
  "uploadedRecords": [],
  "baselineRecords": [],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  },
  "lookbackDays": 90,
  "maxResults": 100,
  "maxEvidence": 10
}
```

# Actor output Schema

## `report` (type: `string`):

No description

## `articles` (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 = {
    "source": "新能源汽车",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": []
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrupulous_buckler/wechat-ecosystem-data-intelligence").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 = {
    "source": "新能源汽车",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": [],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("scrupulous_buckler/wechat-ecosystem-data-intelligence").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "source": "新能源汽车",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  }
}' |
apify call scrupulous_buckler/wechat-ecosystem-data-intelligence --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrupulous_buckler/wechat-ecosystem-data-intelligence",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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