skills.rest
rbudiharso
rbudiharsoCOMMUNITY
Explore all skills by this author →
Website𝕏@rbudiharsoGitHub

xurl

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

2|Updated Oct 20, 2017
Search Tags:#social media#cli#twitter#posting#oauth2#media upload#x api
One-click install
npx skills add https://github.com/rbudiharso/dotfiles --skill xurl-rbudiharso
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/rbudiharso/dotfiles/tree/main/hermes/.hermes/skills/social-media/xurl
Command: npx skills add https://github.com/rbudiharso/dotfiles --skill xurl-rbudiharso

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing X (Twitter) activity from the command line or an agent session requires handling OAuth flows, raw API endpoints, and media uploads manually. This Skill wraps the official xurl CLI so an agent can post, search, reply, like, repost, send DMs, and upload media against the X API v2 while keeping credentials out of the conversation. ## Core Features & Use Cases - Full X API v2 coverage: Post, reply, quote, delete, search raw posts, read timelines and mentions, like, repost, bookmark, follow, block, mute, and send direct messages, all returning JSON to stdout. - Media uploads: Upload images and videos with type/category flags, poll processing status, and attach media IDs to posts. - Multi-app and multi-account auth: OAuth 2.0 PKCE with auto-refresh, isolated per-app tokens, and per-request app or username selection. - Use Case: Ask the agent to search X for posts about a topic, review the returned post JSON, then reply to and like the most relevant ones — all without exposing tokens, since credentials live only in ~/.xurl and are configured by the user outside the session. ## Quick Start Ask the agent to run xurl auth status to verify credentials, then have it search X for a topic and reply to one of the resulting posts.

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 2.0 setup. You can also reply, quote, or attach uploaded media with --media-id flags.

How do I search X posts and get raw post JSON?▼

Run xurl search "query" -n 10 to query the X index as your authenticated account. Results return full post objects with IDs, authors, and text that can be directly liked, replied to, or reposted.

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 your-app. These steps must be done manually outside an agent session since they involve secrets.

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 images and videos to X?▼

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

Does xurl support multiple X accounts or apps?▼

Yes, each registered app has isolated credentials and tokens. Switch with xurl auth default, use --app per request, or select among multiple accounts per app with the -u/--username flag.

Related Skills

Explore More Marketing & Sales Skills→
harlanljonesharlanljones

xurl

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

Community
Intermediate
liushuang393liushuang393

market-trend-analysis

Analyze news articles to extract topics, keywords, and sentiment into a trends report.

Community
Advanced
ClawLink-HQClawLink-HQ
117

postiz-social

Manages social media publishing and content workflows via the Postiz API.

Official
Intermediate
sycskysycsky

auth-http-api-cloudbase

Authenticate CloudBase users via HTTP requests to Auth v2 endpoints.

Community
Advanced