xurl

Operate X/Twitter accounts through the official xurl CLI and v2 API.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/zhoulingxiao1216/testworkspace --skill xurl-zhoulingxiao1216
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/zhoulingxiao1216/testworkspace/tree/main/all_Skills/social-media/xurl
Command: npx skills add https://github.com/zhoulingxiao1216/testworkspace --skill xurl-zhoulingxiao1216

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing X (Twitter) programmatically usually 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 directly from the command line with JSON output. ## Core Features & Use Cases - Full social actions: Post, reply, quote, delete, like, repost, bookmark, follow, block, mute, and send direct messages via simple commands. - Reading and search: Search posts, read timelines and mentions, look up users, and inspect follower graphs with structured JSON results. - Media and raw API access: Upload images and videos with status polling, plus curl-style access to any X API v2 endpoint including streaming. - Use Case: Ask the agent to search recent posts about a product launch, like the top results, and reply to one with a prepared message — all executed through xurl commands with confirmed intent before each write action. ## Quick Start Ask the agent to check 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. It also supports replies, quotes, media attachments via --media-id, and raw POST requests to /2/tweets.

How do I search X/Twitter posts with the API?▼

Run xurl search "query" -n 10 to search recent posts, supporting operators like from:user, hashtags, and lang filters. Results return as JSON matching the X API v2 response structure.

Does xurl support multiple X accounts or apps?▼

Yes, xurl stores isolated credentials per app in ~/.xurl. Switch with xurl auth default APP USER, use --app for one-off requests, or -u to select among multiple authenticated accounts under one app.

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

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 to bind the token correctly.

Can xurl upload videos to X/Twitter?▼

Yes, xurl media upload handles images and videos with automatic type detection. Videos require server-side processing, so poll with xurl media status MEDIA_ID or use --wait before attaching the media ID to a post.