skills.rest
i-bebsi
i-bebsiCOMMUNITY
Explore all skills by this author →
GitHub

xurl

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing X (Twitter) activity from an agent or terminal normally requires juggling API docs, OAuth flows, and raw HTTP calls. This Skill wraps the official xurl CLI so you can post, search, reply, send DMs, upload media, and call any X API 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, and delete posts — all returning JSON. - Reading and engagement: Search posts, read timelines and mentions, like, repost, bookmark, follow, block, and mute accounts. - Raw v2 API access: Use curl-style commands against any X API v2 endpoint, including streaming endpoints and multi-app/multi-account setups. - Use Case: Ask the agent to search X for posts about your product launch, like the top results, and reply to one with a branded message including an uploaded image. ## Quick Start Ask the agent to verify 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: run xurl post "your message" after completing one-time OAuth setup. You can attach media with --media-id after uploading files via xurl media upload, and all responses return as JSON.

How do I authenticate xurl with the X API?▼

Register an app at developer.x.com, then run xurl auth apps add with your client ID and secret, followed by xurl auth oauth2 --app your-app to complete the OAuth 2.0 PKCE flow. Tokens persist in ~/.xurl and auto-refresh.

Can xurl access any X API v2 endpoint?▼

Yes, xurl supports raw curl-style access to any v2 endpoint, for example xurl /2/users/me or xurl -X POST /2/tweets -d '{"text":"hi"}'. It also auto-detects streaming endpoints like /2/tweets/search/stream.

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.

Does xurl support multiple X accounts or apps?▼

Yes, each registered app has isolated credentials and tokens. Switch with xurl auth default APP USER, use --app for per-request overrides, or select accounts with -u/--username.

Related Skills

Explore More Marketing & Sales Skills→
519lab519lab
2

xurl

Manage X/Twitter API interactions via the xurl CLI.

Official
Intermediate
Prorise-coolProrise-cool
24

x-topic-intelligence

Collect and structure X/Twitter posts, influencers, and engagement metrics into JSONL and Markdown.

Community
Intermediate
ekatasingh1107ekatasingh1107
2

social-listener

Monitor social platforms and forums for brand mentions with sentiment and engagement scoring.

Community
Advanced
certdcertd
4.9k

access-plugin-dev

Create custom Access plugins for Certd using TypeScript.

Official
Intermediate