Tweet Monitor Pro

Commercial X/Twitter scraping skill for OpenClaw. No login, no API keys required.

Features

✅ Zero-dependency basics: Fetch single tweets without Camofox
✅ Advanced features: Reply threads, user timelines, Google search (requires Camofox)
✅ Chinese platforms: Weibo, Bilibili, CSDN, WeChat Articles (some without Camofox)
✅ Quota management: Subscription-based usage limits
✅ SkillPay ready: Optional integration for automatic billing

---

Subscription Plans

| Plan | Price/Month | Quota | Features | |------|-------------|-------|----------| | Free | $0 | 10 calls | Single tweet fetch | | Pro | $1.9 | 1,000 calls | All basic + timelines + replies + search | | Business | $9.9 | Unlimited | Everything + API access + priority support |

---

Quick Start

1. Install

# From ClawHub
openclaw skills install tweet-monitor-pro

# Or manual
cp -r tweet-monitor-pro ~/.openclaw/skills/

2. (Optional) Start Camofox for Advanced Features

openclaw plugins install @askjo/camofox-browser
# or manually: git clone https://github.com/jo-inc/camofox-browser && npm install && npm start

3. Use

// Fetch single tweet
const result = await agent.execute('tweet-monitor-pro.fetchTweet', {
  url: 'https://x.com/user/status/123456'
});
console.log(result.data.tweet.text);

// Fetch thread (replies)
const thread = await agent.execute('tweet-monitor-pro.fetchThread', {
  url: 'https://x.com/user/status/123456'
});
console.log(thread.data.replies);

// Fetch user timeline
const timeline = await agent.execute('tweet-monitor-pro.fetchTimeline', {
  username: 'elonmusk',
  limit: 50
});

// Check quota
const quota = await agent.execute('tweet-monitor-pro.getQuota', {});
console.log(`${quota.data.used}/${quota.data.limit} calls used`);

// Upgrade plan
await agent.execute('tweet-monitor-pro.upgradePlan', { plan: 'pro' });

---

Tools

| Tool | Description | Quota Cost | Plan Required | |------|-------------|------------|---------------| | fetchTweet | Fetch single tweet (content + stats) | 1 call | Free+ | | fetchThread | Fetch tweet + all replies (nested) | 3 calls | Pro+ | | fetchTimeline | Fetch user timeline (max 300) | 1 per 50 tweets | Pro+ | | monitorUser | Incremental monitor for new mentions | 1 per check | Pro+ | | getQuota | Check remaining quota | 0 | All | | upgradePlan | Upgrade subscription plan | 0 | All |

---

Commercial Integration

SkillPay.me Integration (Optional)

1. Create your skill on SkillPay.me
2. Get API key and skill ID
3. Set environment variables:

export SKILLPAY_API_KEY="your_key"
export SKILLPAY_SKILL_ID="your_skill_id"

The skill will automatically report usage and trigger billing.

---

Technical Details

• Basic fetching: Uses FxTwitter public endpoint (no authentication)
• Advanced fetching: Camofox + Nitter (bypasses Cloudflare)
• Chinese platforms: Camofox renders JS + custom parsers
• Output format: Standard JSON (text, stats, media URLs)

---

FAQ

Q: Why can't I fetch some tweets?
A: Protected accounts or X restrictions. Public accounts usually work.

Q: What is Camofox?
A: An anti-detection browser service running on localhost:9377. Used to bypass Cloudflare and JavaScript challenges for advanced features.

Q: What happens when my quota runs out?
A: Upgrade to Pro/Business or wait for monthly reset (Free plan).

Q: Can I do bulk fetching?
A: Business plan supports bulk operations via API. For Pro, call multiple times within quota.

---

License

MIT - Commercial use allowed.

---

Support

For issues and feature requests, please open an issue on GitHub.