mcpField
X
x-post

x-post

github.com/rameerezMarketing & growth3174 installsUpdated 36w ago
Repository

About x-post

x-post is a Python CLI skill for publishing text and media to X and checking the authenticated profile. It requires explicit user approval before a post is submitted.

Key features

  1. 01Post text to X
  2. 02Attach images to posts
  3. 03Attach videos with chunked upload
  4. 04Check the authenticated profile
  5. 05Require approval before posting

Use cases

  1. 01Publishing an approved text post
  2. 02Sharing an image or video on X
  3. 03Checking the connected X profile

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rameerez/claude-code-startup-skills --skill x-post

After installing, type/x-postin Claude Code to confirm it loaded.

Bundled filesx-post.py

Details

From the project README

Post to X using the CLI tool at ~/.claude/skills/x-post/x-post.py.

Setup

Requires Python packages: pip install xdk requests_oauthlib

Credentials file at ~/.claude/skills/x-post/x.key (JSON):

{
  "api_key": "...",
  "api_secret": "...",
  "access_token": "...",
  "access_token_secret": "..."
}

Commands

Post text:

python ~/.claude/skills/x-post/x-post.py post "Your tweet text"

Post with image:

python ~/.claude/skills/x-post/x-post.py post "Your tweet text" --media /path/to/image.jpg

Post with video:

python ~/.claude/skills/x-post/x-post.py post "Your tweet text" --media /path/to/video.mp4

Check profile:

python ~/.claude/skills/x-post/x-post.py me

Rules

  • Always show the user the exact tweet text before posting and get confirmation
  • Never post without explicit user approval
  • Video uploads use chunked upload (INIT/APPEND/FINALIZE) and may take a minute for processing
  • The script auto-detects media type from file extension

Comments

Markdown supported