X Research

Use the X API for read-only research into topics, posts, users, conversations, trends, news, Lists, Spaces, and public activity patterns. Prefer API-backed evidence over browser scraping, and keep the exact query, endpoint, time window, and sampling limits visible in the final answer.

Directory Layout

x-research/
├── SKILL.md
├── scripts/
│   ├── x_api.py              # Generic X API CLI + reusable client
│   ├── trend_scan.py         # Topic/query volume and post sample analysis
│   ├── account_scan.py       # Account profile, timeline, and mentions analysis
│   └── conversation_scan.py  # Post/conversation and reply/quote analysis
└── references/
    └── workflows.md          # Endpoint map, command patterns, and research guardrails

Prerequisites