skills.rest
XPOZpublic
XPOZpublicOFFICIAL
Explore all skills by this author →
Website𝕏@xpozaiGitHub

xpoz-best-practices

Guides correct usage of Xpoz MCP tools, SDKs, and CLI for social media data queries.

15|3|Updated Feb 23, 2026
Search Tags:#api reference#pagination#mcp tools#social media data#csv export#query syntax#xpoz
One-click install
npx skills add https://github.com/XPOZpublic/xpoz-agent-skills --skill xpoz-best-practices-xpozpublic
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xpoz-best-practices
Source: https://github.com/XPOZpublic/xpoz-agent-skills/tree/main/skills/xpoz-best-practices
Command: npx skills add https://github.com/XPOZpublic/xpoz-agent-skills --skill xpoz-best-practices-xpozpublic

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with the Xpoz social media intelligence platform requires knowing correct query syntax, field names, pagination patterns, and authentication flows across four interfaces (MCP, Python SDK, TypeScript SDK, CLI). This Skill provides that reference context so agents use Xpoz tools correctly on the first attempt instead of producing malformed queries or empty results. ## Core Features & Use Cases - Query Syntax Reference: Boolean operators, date filtering, and forbidden operators for keyword searches across Twitter/X, Instagram, Reddit, and TikTok. - Response Modes & Pagination: Guidance on fast, paging, and CSV export modes, including the operationId polling pattern and tableName-based page navigation. - Platform Tool References: Detailed parameter and field documentation for all 40 tools (13 Twitter, 9 Instagram, 9 Reddit, 9 TikTok) plus tracking management. - Use Case: When asked to export Reddit posts about a product to CSV, the agent loads this Skill to select the right tool, apply correct field names, set responseType to csv, and poll checkOperationStatus until the download URL is ready. ## Quick Start Ask the agent to search Twitter for posts about a topic using Xpoz, and it will load this reference to apply correct query syntax, fields, and response mode.

Frequently Asked Questions about xpoz-best-practices

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

FAQPage Schema
How do I search Twitter posts by keywords with Xpoz?▼

Call getTwitterPostsByKeywords with a query string supporting boolean operators like AND, OR, and quoted exact phrases. Add startDate and endDate in YYYY-MM-DD format to bound the search, and use the fields parameter to limit returned data.

How do I export Xpoz query results to CSV?▼

Set responseType to "csv" on any paginated tool to trigger an async export to S3. Poll checkOperationStatus with the returned operationId until status is success, then use the downloadUrl. The SDKs and CLI handle polling automatically.

What is the difference between fast and paging response modes?▼

Fast mode returns up to 300 results synchronously in one response, suiting quick lookups. Paging mode is asynchronous, returning an operationId and delivering 100 results per page, which suits large datasets requiring page-by-page iteration.

Does the Xpoz Python SDK use different field names than MCP?▼

Yes. The Python SDK uses snake_case field names like like_count and author_username, while MCP, the TypeScript SDK, and default API responses use camelCase like likeCount and authorUsername. This applies to both input fields parameters and returned data.

Why does my Xpoz query return empty results?▼

Empty results usually come from overly narrow date ranges, unsupported operators like from: or since: in the query string, or misspelled keywords. Widen the date range, use dedicated parameters instead of inline operators, and verify boolean syntax.

How do I authenticate the Xpoz CLI or SDK?▼

Get a free API key from xpoz.ai/get-token and set it as the XPOZ_API_KEY environment variable, or pass it directly to the client constructor or via the --api-key CLI flag. MCP connections authenticate through OAuth on the first tool call.

Related Skills

Explore More Data & Analytics Skills→
mberto10mberto10

MCP Authentication

Implement OAuth 2.1 and API key authentication for OpenAI Apps SDK MCP servers.

Community
Intermediate
QuestNova502QuestNova502
4

apify-ultimate-scraper

Automate cross-platform web data extraction using AI Actors and export JSON or CSV results.

Community
Advanced
browser-actbrowser-act
5.5k

threads-keyword-search

Extract Threads keyword and hashtag search results with engagement metrics from SSR-embedded JSON.

Official
Intermediate
ruuxiruuxi
29

x-api

Manage X/Twitter accounts via Stella's OAuth integration and X API v2.

Community
Intermediate