xurl

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

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

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 gives an agent direct command-line access to the full X API v2 surface through the official xurl CLI, returning structured JSON for every operation. ## Core Features & Use Cases - Posting & Engagement: Create posts, replies, quotes, likes, reposts, and bookmarks, including media uploads for images and video. - Reading & Search: Search posts, read timelines and mentions, look up users, and fetch X Articles via raw v2 endpoints. - Social Graph & DMs: Follow, block, mute, list followers/following, and send or read direct messages. - Use Case: Ask the agent to search X for posts about a product launch, like the top results, and reply to one with a prepared message — all executed as xurl commands with JSON output. ## Quick Start Use the xurl skill to post "Hello world!" to my X account and then show my latest mentions.

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 images or video by uploading media first 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 my-app and then xurl auth default my-app so commands use the named app with valid tokens.

Can xurl access any X API v2 endpoint directly?▼

Yes, beyond shortcut commands xurl supports raw curl-style access such as xurl /2/users/me or xurl -X POST /2/tweets -d '{"text":"Hi"}'. This covers endpoints like X Articles that shortcuts do not handle.