skills.rest
Lento47
Lento47COMMUNITY
Explore all skills by this author →
GitHub

xurl

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

1|Updated Jun 19, 2026
Search Tags:#social media#oauth#cli#twitter#x api#xurl#post automation
One-click install
npx skills add https://github.com/Lento47/arcana-community --skill xurl-lento47
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/Lento47/arcana-community/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/Lento47/arcana-community --skill xurl-lento47

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the X (Twitter) API normally requires writing custom HTTP clients, handling OAuth flows, and parsing raw 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 directly from the terminal with structured JSON output. ## 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 bodies, including streaming endpoints. - Use Case: Ask the agent to search X for mentions of your product, like the top results, and reply to one with a prepared message — all executed through xurl commands returning JSON. ## 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 setup. You can attach media by uploading a file with "xurl media upload photo.jpg" 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" for post search, "xurl timeline -n 20" for your home timeline, and "xurl mentions -n 10" for mentions. All commands return X API v2 JSON to stdout.

Does xurl support multiple X accounts or apps?▼

Yes, xurl stores isolated credentials per app in ~/.xurl. Switch apps with "xurl auth default APP_NAME" or per-request with --app, and select among multiple authenticated users with -u/--username.

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 my-app" and then "xurl auth default my-app" so commands use the registered app.

Can xurl upload videos and images to X?▼

Yes, use "xurl media upload file.mp4" with automatic type detection, or specify --media-type and --category explicitly. Videos require server-side processing, so poll with "xurl media status MEDIA_ID" before posting.

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

Agents must never read ~/.xurl, use --verbose, or pass inline secret flags like --bearer-token or --client-secret. Credential registration and OAuth must be done manually by the user outside the agent session.

Related Skills

Explore More Marketing & Sales Skills→
CyapstayeCyapstaye
9

xurl

Interact with the X API v2 for posting, searching, and account management.

Community
Advanced
vivy-yivivy-yi
363

performance-tracking

Analyzes social media performance metrics to inform content strategy.

Community
Advanced
cdeistopenedcdeistopened

Slack Social Distribution Skill

Post social media content summaries and threaded replies to Slack channels.

Community
Intermediate
ruskicoderruskicoder
3

api-integration

Integrate external REST and GraphQL APIs with secure authentication and retry logic.

Community
Intermediate