x-api

Post, read, search, and analyze X content via OAuth-authenticated API calls.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Maelwalser/claude-config --skill x-api-maelwalser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-api
Source: https://github.com/Maelwalser/claude-config/tree/main/skills/x-api
Command: npx skills add https://github.com/Maelwalser/claude-config --skill x-api-maelwalser

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable reliable programmatic interaction with X (formerly Twitter) so developers and automation systems can post tweets and threads, read timelines and user data, perform searches, and collect engagement analytics without manual API research or ad-hoc implementations.

Core Features & Use Cases

  • Posting & Threads: OAuth 1.0a write flows for single tweets, threaded conversations, and media-attached posts.
  • Reading & Search: OAuth 2 bearer token read flows for timelines, user lookups, and recent search queries.
  • Media Uploads & Analytics: Guidance for v1.1 media uploads, public_metrics tracking, and engagement monitoring.
  • Rate Limits & Error Handling: Best practices to read rate-limit headers, back off safely, and handle common API errors.
  • Integration: Recommended patterns to combine brand-voice and content-engine outputs with approval gates before publishing.

Quick Start

Post a tweet with the text 'Hello from Claude Code' using OAuth 1.0a credentials, return the posted tweet ID, and handle rate-limit and error responses.

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 using the X API?

Automate posting tweets and threads by using OAuth 1.0a write flows to authenticate requests and send single or threaded posts programmatically. The Skill handles authentication and content sequencing for reliable automated publishing.

What's the best way to search and read X timelines programmatically?

Search and read X timelines by using OAuth 2 bearer token read flows for recent search queries and timeline retrieval. The Skill manages authentication, user lookups, and timeline data extraction for analytics workflows.

How do I upload media to X for automated tweets via the API?

Upload media to X for automated tweets by utilizing the v1.1 media upload endpoints before attaching the returned media ID to your post. The Skill provides guidance on v1.1 media integration for OAuth 1.0a write actions.

How do I handle X API rate limits and errors in my automation workflow?

Handle X API rate limits and errors by reading rate-limit headers and implementing safe backoff strategies. The Skill enforces rate-limit awareness and error handling best practices to maintain robust integrations during automated posting and search operations.

Do I need OAuth 1.0a or OAuth 2 bearer tokens for X API read and write operations?

Use OAuth 1.0a for write operations like posting tweets and media uploads, and OAuth 2 bearer tokens for read and search operations like retrieving timelines and user data. The Skill satisfies both authentication protocols based on the action required.

Can I track engagement and public metrics for X content programmatically?

Track engagement and public metrics for X content programmatically by retrieving public_metrics data through authenticated read flows. The Skill supports engagement monitoring and analytics tracking for automated workflow reporting.