skills.rest
Araara7
Araara7COMMUNITY
Explore all skills by this author →
GitHub

xurl

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the X (Twitter) API normally requires writing custom HTTP clients, handling OAuth 2.0 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 v2 endpoint with simple commands that return structured JSON. ## Core Features & Use Cases - Full posting workflow: Create posts, replies, quotes, and threads, attach images or video via media upload, and delete posts. - Reading and engagement: Search posts, read timelines and mentions, like, repost, bookmark, follow, block, mute, and send direct messages. - Raw v2 API access: Use curl-style commands against any X API v2 endpoint, including streaming endpoints, with multi-app and multi-account support. - Use Case: Ask the agent to search X for recent posts about your product, like the most relevant ones, and reply to a specific post with an attached image — all executed through xurl commands returning JSON. ## Quick Start Ask the agent to run xurl auth status to verify credentials, then have it post "Hello world" to your X account using the xurl post command.

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: run xurl post "your text" after completing one-time OAuth setup. You can attach media with --media-id after uploading files via xurl media upload, and reply or quote with xurl reply POST_ID or xurl quote POST_ID.

How do I authenticate xurl with the X API?▼

Register an app at the X developer portal, then run xurl auth apps add with your client ID and secret, followed by xurl auth oauth2 --app my-app for the OAuth 2.0 PKCE browser flow. Set it as default with xurl auth default my-app and verify with xurl auth status.

Can xurl access any X API v2 endpoint directly?▼

Yes, xurl supports raw curl-style access to any v2 endpoint, such as xurl /2/users/me or xurl -X POST /2/tweets -d '{"text":"Hello"}'. It also supports custom headers, DELETE/PUT/PATCH methods, and streaming endpoints with the -s flag.

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 app that holds your client ID and secret.

Does xurl support uploading videos to X?▼

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

Is it safe to use xurl inside an AI agent session?▼

Yes, provided the safety rules are followed: never read or print ~/.xurl, never pass inline secret flags like --bearer-token or --client-secret, and never use --verbose which can leak auth headers. Credential registration must be done manually by the user outside the agent.

Related Skills

Explore More Marketing & Sales Skills→
i-bebsii-bebsi

xurl

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

Community
Intermediate
InsightpulseaiInsightpulseai

Performance Review

Analyze social media engagement metrics and KPIs to generate strategy recommendations.

Official
Intermediate
SanctifiedOpsSanctifiedOps
3

social-signal-bot

Automate rate-limited posting and reply monitoring on X and Telegram.

Community
Intermediate
DazlarusDazlarus

api-integration

Implements async HTTP clients with retry logic, timeouts, rate limiting, and response validation.

Community
Intermediate