twitter-data-export

Export Twitter/X search results to CSV datasets via the Xpoz API.

15|3|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/XPOZpublic/xpoz-agent-skills --skill twitter-data-export-xpozpublic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: twitter-data-export
Source: https://github.com/XPOZpublic/xpoz-agent-skills/tree/main/skills/twitter-data-export
Command: npx skills add https://github.com/XPOZpublic/xpoz-agent-skills --skill twitter-data-export-xpozpublic

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires xpoz, @xpoz/xpoz, pandas.

What problem does it solve? Getting large volumes of Twitter/X data for analysis normally requires paid API access and custom scraping code. This Skill lets you search tweets by keyword, author, or date range and export complete datasets to CSV (up to 500K rows) without any Twitter API keys. ## Core Features & Use Cases - Keyword & Author Search: Query tweets with boolean operators (AND, OR, NOT), filter by author, language, and date range. - Bulk CSV Export: Download full result sets up to 500K rows via a generated CSV download URL, with selectable fields like likes, retweets, impressions, and replies. - Multiple Access Paths: Works through MCP tools (mcporter or Claude Code) or the Xpoz Python/TypeScript SDKs with a free access key. - Use Case: Ask to export all tweets mentioning "Claude Code" from the last two weeks, then load the CSV into pandas to analyze engagement trends and top authors. ## Quick Start Ask your agent to export tweets about a topic to CSV, for example: "Export all tweets mentioning 'artificial intelligence' from last month to a CSV file."

Frequently Asked Questions about twitter-data-export

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export tweets to CSV without a Twitter API key?

Use the Xpoz API, which handles all Twitter data access without requiring Twitter API keys. Search tweets by keyword or author, then call the CSV export to receive a download URL for the complete dataset, up to 500K rows.

How to search tweets by keyword and date range?

Call getTwitterPostsByKeywords with a boolean query (e.g., "AI" OR "machine learning"), plus startDate and endDate parameters in YYYY-MM-DD format. You can also filter by language and select specific fields like likeCount and impressionCount.

What is the maximum number of tweets I can export?

A single CSV export supports up to approximately 500K rows. The free Xpoz access key covers up to 75K results, while the Pro plan at $20 per month allows 1M results. Date ranges support up to 60-day rolling windows.

Does the Xpoz MCP integration work with Claude Code?

Yes. Add the server with 'claude mcp add --transport http xpoz https://mcp.xpoz.ai/mcp' and Claude Code handles OAuth automatically on the first tool call. Alternatively, use the Python or TypeScript SDK with an XPOZ_API_KEY environment variable.

Why does my tweet search return an operationId instead of data?

Xpoz searches run asynchronously, so calls return an operationId rather than immediate results. Poll checkOperationStatus with that ID until the status is completed, retrying up to 8 times about 5 seconds apart, then retrieve results or the CSV export URL.