WeChat Article Crawler with x402 Payment

微信公众号文章爬虫 - x402 支付版

支持实时支付（小额）和异步支付（大额）混合模式，使用 Base 链 USDC 支付。

When to Use

Use this skill when you need to:

• - Monitor competitor accounts: Track what other WeChat Official Accounts are publishing
• Content research: Gather articles from specific niches for analysis
• Archive building: Download complete post history from valuable accounts
• Keyword filtering: Find articles matching specific topics with weighted scoring
• Automated reporting: Schedule daily crawls of key accounts
• Price: Free tier (10 articles), then $0.1/article or $10/account via x402 on Base

Pricing

计费模式	价格	说明
按篇	$0.1 USDC/篇	适合少量精准获取
按号

$10 USDC/号 | 批量获取某号全部历史文章 | | 包月 | $100 USDC/月 | 30天无限使用 | | 免费 | 10篇 | 新用户免费体验 |

Payment Modes

实时支付（<$5）

• - 小额支付，即时确认
• 支付后立即开始爬取
• 适合：按篇计费、少量文章

异步支付（≥$5）

• - 大额支付，后台处理
• 支付确认后加入队列
• 完成后通过 webhook 通知
• 适合：按号计费、批量爬取

Quick Start

1. Set User ID (Required)

CODEBLOCK0

2. Check Status

CODEBLOCK1

3. Crawl with Free Quota

CODEBLOCK2

4. Real-time Payment (small amount)

CODEBLOCK3

5. Async Payment (large amount)

CODEBLOCK4

6. Check Task Status

CODEBLOCK5

7. Subscribe Monthly

CODEBLOCK6

x402 Payment Flow

CODEBLOCK7

File Structure

CODEBLOCK8

Configuration

Edit config.py to customize:

CODEBLOCK9

Dependencies

CODEBLOCK10

Required: Python 3.8+, Google Chrome browser

Workflow Examples

Example 1: New User with Free Quota

CODEBLOCK11

Example 2: Real-time Payment

CODEBLOCK12

Example 3: Async Payment

CODEBLOCK13

Troubleshooting

Payment Issues

"Transaction not found"

• - Ensure you're on Base network (not Ethereum mainnet)
• Wait 30-60 seconds for transaction to be mined
• Check transaction on BaseScan

"Insufficient amount"

• - Verify you sent enough USDC (include decimals)
• Check transaction details for exact amount sent

"Payment expired"

• - Payment requests expire after 5 minutes
• Create a new crawl request

Crawl Issues

"WeChat login failed"

• - Close VPN before running
• Delete weixin_credentials.py and retry
• Use a different WeChat account (small accounts have lower ban risk)

"No articles found"

• - Verify the account name is correct (case-sensitive)
• Account may not have published recently
• Try searching for account first

"Account blocked"

• - WeChat detected automated access
• Wait 24 hours before retrying
• Reduce crawl frequency (built-in 5-15s delays help)

"Chrome not found"

• - Install Google Chrome: https://www.google.com/chrome/
• Or set CHROME_BIN environment variable to Chrome executable path

Installation Issues

"ModuleNotFoundError: No module named 'selenium'"
CODEBLOCK14

"ChromeDriver version mismatch"
CODEBLOCK15

Important Notes

1. 1. WeChat Account Risk

- WeChat may ban accounts used for crawling - Use a secondary/dedicated account - Never use your primary WeChat account

1. 2. VPN Must Be Disabled

- Close all VPN connections before crawling - VPN causes WeChat login timeouts

1. 3. Rate Limiting

- Built-in 5-15 second random delays between requests - Don't run multiple crawls simultaneously - Daily limit: 100-200 articles recommended

1. 4. Base Chain Requirements

- Ensure wallet has Base network USDC - Keep small amount of ETH for gas fees - Verify receiving address before sending

On-Chain Verification

Enable on-chain verification for production:

CODEBLOCK16

Security Considerations

• - Receiving Address: Double-check 0x172444FC64e2E370fCcF297dB865831A1555b07A before sending payments
• Private Keys: Never share wallet private keys; skill only needs public address
• Data Storage: User data stored locally in data/ directory
• WeChat Credentials: Saved in weixin_credentials.py; keep this file secure

Data Storage Locations

The skill stores data in the following locations (relative to skill directory):

CODEBLOCK17

Tips

• - Free tier first: Always test with 10 free articles before paying
• Batch efficiently: Crawl full account history ($10) instead of many small payments
• Subscribe if regular: Monthly subscription pays for itself after 1000 articles
• Monitor task status: Async tasks can be checked anytime with INLINECODE5
• Use testnet first: Test on Base Sepolia with test USDC before mainnet
• Save credentials: After first login, weixin_credentials.py allows 24hr re-access
• Account safety: Rotate WeChat accounts monthly to reduce ban risk
• VPN reminder: Always disable VPN; check with curl ipinfo.io if unsure
• Payment receipts: Keep transaction hashes for dispute resolution
• Error logs: Check data/queue/tasks.json for failed task details

License

MIT License - For educational and research purposes only

---

x402 Powered ⚡️ Programmatic payments via x402 protocol on Base