x-api
Search X (Twitter) posts, pull user profiles, fetch specific tweets, and read reply threads for sentiment, news, and event research. Triggers on 'X', 'Twitter', 'tweets about', 'sentiment on', 'what are people saying about', 'historical tweets', or any request to read public X content.
npx skills add ginlix-ai/LangAlpha --skill x-api --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# X (Twitter) API Read-only access to X content via five MCP tools. Use for sentiment on tickers, exec announcements, launches, event tracking, and qualitative research alongside SEC/market data. > **Not for single-post URL lookups.** If the user hands you a specific X post URL and just wants its text or context, use `web_fetch` on the URL — no vault, no auth, no rate limit. Reach for this skill when the task is **search, aggregation, or thread traversal**. ## Auth Every tool requires a `bearer_token`. Read it once per code block from the workspace vault: ```python from vault import get token = get("X_BEARER_TOKEN") ``` If `token` is `None` or empty, the user hasn't added it yet. For the setup walkthrough and per-error fixes, see [TROUBLESHOOTING.md](./TROUBLESHOOTING.md). ## Tools at a glance The primary use case is **search** — the first two tools are what you'll reach for most. | Tool | Use for | Page size | Notes | |---|---|---|---| | `search_posts` | Posts from the last ~7 days | default 10, max 100 | Default choice. Query ≤512 chars. | | `search_all_posts` | Posts older than 7 days (back to 2006) | default 10, max 500 | Paid-tier X plan only. Query ≤1024 chars. | | `get_conve
- Auth
- Tools at a glance
- Examples
- Recent sentiment on a ticker
- Historical reaction to a past event
- Full thread on a specific tweet
- Paginate through a large result
- Post shape
- Query syntax
- Errors
- Do / Don't
- Related
What does the x-api skill do?
Search X (Twitter) posts, pull user profiles, fetch specific tweets, and read reply threads for sentiment, news, and event research. Triggers on 'X', 'Twitter', 'tweets about', 'sentiment on', 'what are people saying about', 'historical tweets', or any request to read public X content.
How do I install it?
Run `npx skills add ginlix-ai/LangAlpha --skill x-api --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From ginlix-ai/LangAlpha, a repository with 1,604 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.