skills.rest
AmirulAndalib
AmirulAndalibCOMMUNITY
Explore all skills by this author →
GitHub

xurl

Executes authenticated X API operations including posts, reads, DMs, and media uploads via the xurl CLI.

Updated Jun 19, 2026
Search Tags:#social media#api#cli#twitter#posting#x#media upload
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill xurl-amirulandalib
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/xurl
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill xurl-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires xurl.

What problem does it solve? Interacting with the X (Twitter) API requires managing OAuth credentials, constructing raw HTTP requests, and handling media upload workflows. This Skill wraps the xurl CLI so an agent can post, read, search, and manage X content with simple commands while keeping tokens out of chat. ## Core Features & Use Cases - Posting and engagement: Create posts, replies, quotes, likes, reposts, and bookmarks, plus follow, block, and mute operations. - Reading and search: Fetch posts by ID or URL, search recent posts, read timelines, mentions, followers, and direct messages. - Media and raw API access: Upload images and videos with processing-status polling, and call any v2 endpoint directly in raw mode. - Use Case: Ask the agent to search X for mentions of your product, then reply to a specific post and DM the author, all through authenticated xurl commands. ## Quick Start Use the xurl skill to check auth status and then post "Hello world!" to my X account.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I post to X (Twitter) from the command line?▼

Use the xurl CLI with the command xurl post "your message" after configuring authentication. It also supports replies, quotes, and deletes by passing a post ID or full x.com status URL.

How do I search X posts using the API?▼

Run xurl search "query" -n 20 to retrieve recent posts matching a query as JSON. For custom filters, use raw mode with the /2/tweets/search/recent endpoint and query parameters.

How do I upload images or videos to X via API?▼

Upload media with xurl media upload image.jpg, then attach it using xurl post "caption" --media-id MEDIA_ID. Videos may require processing, so poll xurl media status MEDIA_ID before posting.

Why does the X API return 401 or 403 errors?▼

A 401 or 403 indicates an authentication, scope, or app mismatch problem. Run xurl auth status to verify credentials, and check that the correct app is selected with xurl auth apps list or the --app flag.

Can xurl access X API endpoints not covered by shortcuts?▼

Yes, raw mode supports any v2 endpoint, for example xurl /2/users/me or xurl -X POST /2/tweets -d '{"text":"Hi"}'. Keep complex JSON payloads in temp files to avoid shell escaping issues.

Related Skills

Explore More Marketing & Sales Skills→
trpc-grouptrpc-group
1.8k

xurl

Executes authenticated X API v2 requests for posting, searching, and social graph operations.

Official
Intermediate
enunoenuno

social-monitor

Monitor social media mentions and sentiment using XAI and Reddit APIs.

Community
Intermediate
winsorllcwinsorllc

agent-send

Send messages to AI agents across Discord, Telegram, Slack, and email.

Community
Intermediate
scalekit-incscalekit-inc
2

express-mcp-server

Create Express.js MCP servers with TypeScript and OAuth 2.1 Bearer token authentication.

Official
Advanced