twitter-agent-skill

# 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.

# Twitter Agent Skill

Async tooling for Twitter/X automations that rely on cookie-based auth (`auth_token` + `ct0`). This packages the client wrappers and helper scripts we use in GanClaw’s social stack so other agents don’t have to rebuild the plumbing.

## Features
- `twitter_api/` package (aiohttp) with modules for tweets, users, relationships, timeline service, etc.
- Helper scripts under `scripts/`:
  - `timeline_summary.py` – fetch the home timeline and summarize top authors/topics.
  - `fetch_notifications.py` – pull notifications and store them as JSON.
  - `analyze_signal.py` – combine timeline + notifications into a markdown signal report.
  - `post_custom_tweet.py` – publish a tweet from any configured account.
  - `follow_account.py` – make every configured account follow a given handle.
- Auth is session-based (same cookies your browser uses) so there’s no dependency on official API keys.

## Requirements
- Python 3.10+
- `pip install -r requirements.txt`
- `.env` file with session cookies for each account you want to automate.

### Environment variables
Copy `.env.example` to `.env` and fill the cookies for each account you care about. Example:
```
ACCOUNT_A_AUTH_TOKEN=auth_token_here
ACCOUNT_A_CT0=ct0_here
ACCOUNT_B_AUTH_TOKEN=
ACCOUNT_B_CT0=
...
```
You can rename the env keys—just update `ACCOUNT_ENV` in the helper scripts so the labels match the keys you choose.

## Usage
```
git clone https://github.com/GAN12003/twitter-agent-skill.git
cd twitter-agent-skill
python -m venv .venv && .venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env  # fill in your auth_token + ct0 values

# timeline + notification summaries
python scripts/timeline_summary.py
python scripts/fetch_notifications.py
python scripts/analyze_signal.py

# posting / following (pass one of the logical account labels)
python scripts/post_custom_tweet.py account_a "hello from the telemetry deck"
python scripts/follow_account.py thenfter07
```
All scripts load the `...