xurl

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

16|Updated Sep 22, 2026
One-click install
npx skills add https://github.com/igniteenow/robo --skill xurl-igniteenow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/igniteenow/robo/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/igniteenow/robo --skill xurl-igniteenow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the X (Twitter) API normally requires writing custom HTTP clients, managing OAuth tokens, and parsing raw responses. This Skill wraps the official xurl CLI so an agent can post, search, reply, like, follow, send DMs, and upload media on X using simple terminal commands that return structured JSON. ## Core Features & Use Cases - Full X API v2 coverage: Post, reply, quote, delete, search posts, read timelines and mentions, like, repost, bookmark, follow, block, mute, and send direct messages. - Media uploads: Upload images and videos, poll processing status, and attach media IDs to posts. - Raw endpoint access: Run curl-style requests against any X API v2 endpoint, including streaming endpoints, with multi-app and multi-account credential support. - Use Case: Ask the agent to search X for recent posts about a topic, review the returned post JSON, then reply to or repost selected posts — all from the terminal with OAuth 2.0 tokens that auto-refresh. ## Quick Start Ask the agent to check xurl auth status and then search X for the five most recent posts about a topic you care about.

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 text" after completing one-time OAuth setup. It also supports replies, quotes, deletes, and attaching uploaded media via --media-id flags.

How to search X posts and get raw JSON results?▼

Run xurl search "QUERY" -n 10 to query the X index as your authenticated account. Results return raw post objects with IDs, authors, and full text that can be immediately engaged with via reply, like, or repost.

Does xurl support uploading images and videos to X?▼

Yes, xurl media upload handles images and videos with auto-detected types or explicit --media-type and --category flags. Videos require server-side processing, which you can poll using xurl media status --wait MEDIA_ID.

Why do xurl commands fail with auth errors after OAuth succeeded?▼

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 xurl auth default your-app, then verify with xurl auth status.

Can xurl access any X API v2 endpoint directly?▼

Yes, beyond shortcut commands, xurl supports raw curl-style requests like xurl -X POST /2/tweets -d '{"text":"Hello"}' with custom headers, HTTP methods, and streaming endpoints.