skills.rest
AjayRajan05
AjayRajan05COMMUNITY
Explore all skills by this author →
WebsiteGitHub

xurl

Post, search, and manage X/Twitter content via the official xurl CLI.

5|2|Updated Mar 12, 2026
Search Tags:#social media#api#cli#twitter#x#post#xurl
One-click install
npx skills add https://github.com/AjayRajan05/VoiceOS --skill xurl-ajayrajan05
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/AjayRajan05/VoiceOS/tree/main/skills/bundled/community/social-media/xurl
Command: npx skills add https://github.com/AjayRajan05/VoiceOS --skill xurl-ajayrajan05

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing X (Twitter) activity from the command line or an AI agent normally requires writing custom API clients, handling OAuth flows, and parsing raw HTTP responses. This Skill wraps the official xurl CLI so an agent can post, search, reply, send DMs, upload media, and call any X API v2 endpoint with simple commands that return structured JSON. ## Core Features & Use Cases - Full posting workflow: Create posts, replies, quotes, and threads, attach images or video via media upload, and delete posts when needed. - Reading and engagement: Search posts, read timelines and mentions, like, repost, bookmark, follow, block, mute, and send direct messages. - Raw API access: Call any X API v2 endpoint curl-style with custom methods, headers, and JSON bodies, including streaming endpoints. - Use Case: Ask the agent to search X for posts about a product launch, like the most relevant ones, and reply to a specific post with an attached image — all executed through xurl commands with JSON output. ## Quick Start Ask the agent to verify xurl is authenticated with "xurl auth status" and then post "Hello world!" to your 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 completing one-time OAuth 2.0 setup. You can attach media by uploading a file with xurl media upload and passing the returned media ID via --media-id.

How do I search X posts and read timelines with xurl?▼

Run xurl search "query" -n 10 to search posts, xurl timeline -n 20 for your home timeline, and xurl mentions -n 10 for mentions. All commands return structured JSON matching the X API v2 response format.

Does xurl support multiple X accounts or apps?▼

Yes, xurl supports multiple registered apps with isolated credentials and multiple user accounts per app. Switch with xurl auth default APP USER, or override per request using the --app and --username flags.

Why do I get auth errors after a successful OAuth flow with xurl?▼

The token was likely saved to the built-in default app profile, which has no client credentials. Re-run xurl auth oauth2 --app your-app and then xurl auth default your-app so commands use the correct registered app.

Can xurl upload images and videos to X?▼

Yes, xurl media upload handles images and videos with auto-detected types. Videos require server-side processing, so check readiness with xurl media status MEDIA_ID or use --wait before attaching the media ID to a post.

What are the limitations of using xurl in an AI agent session?▼

The agent must never read ~/.xurl, pass inline secrets, or use --verbose, since these expose tokens. Credential registration and OAuth must be done manually by the user outside the agent session, and X API usage typically requires a paid plan.

Related Skills

Explore More Marketing & Sales Skills→
i-bebsii-bebsi

xurl

Post, search, and manage X/Twitter content via the official xurl CLI and v2 API.

Community
Intermediate
ibreez3ibreez3
21

小红书自动发稿 Skill

Publish and manage Xiaohongshu posts via MCP tool calls.

Community
Intermediate
nexscope-ainexscope-ai
632

social-media-monitor

Monitor social media mentions, trends, and competitor activity across platforms.

Official
Intermediate
matthew-johnsonmatthew-johnson

duckduckgo-search

Search DuckDuckGo for text, news, images, and videos without API keys.

Community
Intermediate