xurl

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

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill xurl-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/CHENHUI-X/toolbox/tree/main/official-skills/social-media/xurl
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill xurl-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the X (Twitter) API normally requires writing custom HTTP clients, managing OAuth flows, 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 through simple commands that return structured JSON. ## Core Features & Use Cases - Full posting workflow: Create posts, replies, quotes, and threads, attach uploaded images or videos, and delete posts by ID or URL. - Raw post search and reading: Search the X index and receive actual post JSON with IDs that can be immediately engaged with, plus timeline, mentions, and user lookups. - Social graph and DMs: Follow, block, mute, list followers, and send direct messages, with multi-app and multi-account credential support. - Use Case: Ask the agent to search X for posts about your product launch, like the most relevant ones, and reply to a top post with a branded message including an uploaded image. ## Quick Start Ask the agent to search X for posts about a topic and reply to one of them using xurl.

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. 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 get raw JSON results?

Run xurl search "query" -n 10 to query the X index as your authenticated account. It returns raw post objects with IDs, authors, and full text, so results can be immediately liked, replied to, or reposted.

Does xurl support multiple X accounts or apps?

Yes, xurl supports multiple registered apps with isolated credentials and multiple accounts per app. Switch with xurl auth default APP USER, or use --app and -u flags per request.

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

Can xurl upload videos to X?

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