skills.rest
maopujie10-sys
maopujie10-sysCOMMUNITY
Explore all skills by this author →
GitHub

xurl

Operate X/Twitter accounts through the official xurl CLI and v2 API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing X (Twitter) activity from an agent session normally requires handling OAuth flows, raw HTTP requests, and credential safety manually. This Skill wraps the official xurl CLI so an agent can post, search, reply, send DMs, upload media, and call any X API v2 endpoint while keeping tokens out of the LLM context. ## Core Features & Use Cases - Full X API coverage: Post, reply, quote, delete, search, read timelines and mentions, like, repost, bookmark, follow, block, mute, and send direct messages, all returning structured JSON. - Media uploads: Upload images and videos with server-side processing status checks, then attach media IDs to posts. - Raw v2 endpoint 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 posts about a product launch, like the most relevant ones, and reply to a specific post with an attached image — all executed through xurl commands with credentials kept safely outside the conversation. ## Quick Start Ask the agent to verify xurl is installed and authenticated with "xurl auth status", then have it post a short message 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 with the command "xurl post \"your message\"" after completing one-time OAuth 2.0 setup. You can attach media by uploading a file 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" for post search, "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" for persistent selection or use the --app and -u flags for per-request overrides.

Why do I get auth errors after a successful xurl 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 my-app" and then "xurl auth default my-app" so commands use the app that holds your client ID and secret.

Can xurl upload videos to X?▼

Yes, run "xurl media upload video.mp4" and then check processing with "xurl media status MEDIA_ID" or "xurl media status --wait MEDIA_ID". Videos require server-side processing before they can be attached 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 the ~/.xurl credentials file, never pass inline secret flags like --bearer-token or --client-secret, and never use --verbose. Credential registration and OAuth must be done manually by the user outside the agent.

Related Skills

Explore More Marketing & Sales Skills→
hugotownhugotown

xurl

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

Community
Intermediate
vivy-yivivy-yi
363

performance-tracking

Analyzes social media performance metrics to inform content strategy.

Community
Advanced
ClawLink-HQClawLink-HQ
117

postiz-social

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

Official
Intermediate
ruuxiruuxi
29

x-api

Manage X/Twitter accounts via Stella's OAuth integration and X API v2.

Community
Intermediate