xurl

Executes authenticated X API operations including posts, reads, DMs, and media uploads via the xurl CLI.

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill xurl-jerome-prakash-l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/JEROME-PRAKASH-L/openclaw/tree/main/skills/xurl
Command: npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill xurl-jerome-prakash-l

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires xurl.

What problem does it solve? Interacting with the X (Twitter) API requires managing OAuth credentials, constructing raw HTTP requests, and handling media upload workflows. This Skill wraps the xurl CLI so you can post, read, search, and manage X content with simple commands while keeping credentials safely out of chat. ## Core Features & Use Cases - Posting and engagement: Create posts, replies, quotes, likes, reposts, and bookmarks, plus follow, block, and mute operations. - Reading and search: Fetch posts by ID or URL, search recent posts, read timelines, mentions, followers, and direct messages as JSON. - Media uploads: Upload images and videos, poll processing status, and attach media to posts. - Raw API access: Call any X API v2 endpoint directly when shortcuts do not cover it, with per-request app and auth selection. - Use Case: Ask the assistant to search X for mentions of your product, then reply to a specific post and DM a follow-up message to the author. ## Quick Start Use the xurl skill to check auth status and then post "Hello world!" to my 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 from the command line?

Use the xurl CLI with the post shortcut: xurl post "your message". It returns JSON on success and supports attaching media via --media-id after uploading files with xurl media upload.

How do I search X posts using the API?

Run xurl search "query" -n 20 to get recent matching posts as JSON. For finer control, use raw mode with the /2/tweets/search/recent endpoint and custom query parameters.

How do I upload images or videos to X with xurl?

Run xurl media upload image.jpg or clip.mp4 to get a media ID, then attach it with xurl post "caption" --media-id MEDIA_ID. Videos may need processing, so poll xurl media status MEDIA_ID before posting.

Why does xurl return 401 or 403 errors?

A 401 or 403 indicates an authentication, scope, or app mismatch problem. Run xurl auth status to verify credentials, and check that the correct app is selected with xurl auth default or the --app flag.

Can xurl access X API endpoints not covered by shortcuts?

Yes, raw mode supports any X API v2 endpoint, for example xurl /2/users/me or xurl -X POST /2/tweets -d '{"text":"Hello"}'. Keep complex JSON payloads in temp files for reliability.

Is it safe to use xurl credentials in an AI agent session?

Yes, provided you follow the safety rules: never read or print ~/.xurl, never paste tokens into chat, avoid inline secrets in auth commands, and do not use --verbose since it can expose auth headers.