---
name: twitter-api
description: "Cookie-based Twitter/X automation toolkit (timeline, notifications, posting, follow ops) for OpenClaw agents."
metadata:
  openclaw:
    emoji: "🐦"
    requires:
      bins: ["python", "git"]
  minis:
    originalSource: "https://clawskills.sh/skills/gan12003-twitter-api"
    convertedAt: "2026-10-31T22:14:44.459Z"
    license: "Unknown"
---

# twitter-agent-skill

## Summary
Async Twitter/X client and scripts that rely on auth_token + ct0 cookies (no official API keys). Supports:
- Home timeline fetch + summary (`scripts/timeline_summary.py`).
- Notifications fetch + signal analysis (`scripts/fetch_notifications.py`, `scripts/analyze_signal.py`).
- Posting and follow automation via env-driven account labels (`scripts/post_custom_tweet.py`, `scripts/follow_account.py`).
- Full async client (`twitter_api/`) with modules for tweets, users, relationships, DMs, etc.

## Setup
1. `pip install -r requirements.txt` (Python 3.10+).
2. Copy `.env.example` → `.env` and fill cookies per account (auth_token + ct0 from logged-in sessions).
3. Run scripts from repo root, e.g.:
   ```
   python scripts/timeline_summary.py
   python scripts/post_custom_tweet.py account_a "hello"
   python scripts/follow_account.py thenfter07
   ```

## Notes
- Env variable names are generic (`ACCOUNT_A_AUTH_TOKEN`, etc.); rename as needed and adjust `ACCOUNT_ENV` dicts in the scripts.
- Respect Twitter/X ToS and do not spam.
- Designed for GanClaw social ops, but neutral enough for other agents to reuse.