x-api

Post tweets, read timelines, search content, and retrieve engagement analytics via the X API.

Updated May 4, 2026
One-click install
npx skills add https://github.com/gganbukim1/myskills --skill x-api-gganbukim1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-api
Source: https://github.com/gganbukim1/myskills/tree/main/x-api
Command: npx skills add https://github.com/gganbukim1/myskills --skill x-api-gganbukim1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

X API integration removes the manual effort of posting tweets or threads, pulling timelines and search results, and collecting engagement data by giving you a reliable programmatic path into X’s endpoints.

Core Features & Use Cases

  • Post tweets and threads for automation, bot posting, or scheduled publishing with reply chaining.
  • Read timelines and user data to fetch mentions, recent posts, and metrics for reporting or moderation.
  • Search and analytics to query conversations or trends and use returned public metrics to measure engagement.
  • Use correct authentication patterns with OAuth 2.0 app-only for read-heavy operations and OAuth 1.0a user context for write actions.

Quick Start

Tell the AI: “Give me a Python example that uses X API OAuth 2.0 bearer token to search recent tweets for ‘claude code’ and print the tweet IDs.”

Frequently Asked Questions about x-api

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

FAQPage Schema
How do I automate posting tweets and threads programmatically using the X API?

You can automate posting tweets and threads by using OAuth 1.0a user-context authentication for write actions. This allows your workflow to handle tweeting, reply chaining, and uploading media programmatically without manual intervention.

How do I search recent tweets using an OAuth 2.0 bearer token?

You can search recent tweets by applying OAuth 2.0 app-only authentication for read-heavy operations. Construct endpoint-specific requests to query conversations or trends and retrieve matching tweet IDs and content.

How does rate limit handling work for X API timeline reading and search requests?

Rate limit handling for X API requests relies on runtime monitoring of response headers. Your application must parse these headers to track remaining quotas and apply aware error handling to prevent hitting request limits during heavy read operations.

Do I need OAuth 1.0a or OAuth 2.0 to retrieve engagement analytics and public metrics?

You need OAuth 2.0 app-only authentication to retrieve engagement analytics and public metrics. It is designed for read-heavy operations like fetching mentions, recent posts, and measuring engagement from search results.

Can I use environment variables for X API token handling in posting automation?

Yes, correct token handling via environment variables is required for X API posting automation. This ensures secure management of your OAuth 1.0a credentials when executing write actions like tweeting threads and uploading media.

What is the best way to fetch mentions and user timelines for reporting workflows?

The best way to fetch mentions and user timelines for reporting is using OAuth 2.0 app-only authentication. It supports reliable programmatic reading of timelines and user data to collect metrics for moderation or reporting workflows.