skills.rest
loteiron
loteironCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

xurl

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

Updated Sep 10, 2026
Search Tags:#social media#oauth#cli#twitter#posting#x api#xurl
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill xurl-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/loteiron/ZeusAgent/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill xurl-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the X (Twitter) API from an agent session normally requires handling OAuth flows, endpoint URLs, and JSON payloads manually. This Skill wraps the official xurl CLI so an agent can post, search, reply, like, follow, send DMs, and upload media with simple commands that return structured JSON. ## Core Features & Use Cases - Full X API v2 coverage: Shortcut commands for posting, replying, quoting, deleting, searching, timelines, mentions, likes, reposts, bookmarks, follows, blocks, mutes, and DMs, plus raw curl-style access to any v2 endpoint. - Media uploads: Upload images and videos, poll processing status, and attach media IDs to posts. - Multi-app and multi-account auth: OAuth 2.0 PKCE with auto-refreshing tokens, isolated per-app credentials, and per-request app or username selection. - Use Case: Ask the agent to search X for recent posts about a topic, review the returned post JSON, then like and reply to the most relevant ones — all through authenticated xurl commands. ## Quick Start Ask the agent to run xurl auth status to verify credentials, then 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 xurl post followed by your message text, such as xurl post "Hello world!". You can attach media by first running xurl media upload and passing the returned ID with --media-id. All output is JSON.

How do I search X posts and reply to them with xurl?▼

Run xurl search "QUERY" -n 10 to get raw post JSON including IDs and authors. Then engage directly with xurl reply POST_ID "text", xurl like POST_ID, or xurl repost POST_ID. POST_ID also accepts full x.com URLs.

Does xurl support multiple X accounts or apps?▼

Yes. Each registered app has isolated credentials and tokens. Switch with xurl auth default APP USER, or use --app NAME per request and -u/--username to select among multiple OAuth2 accounts under one app.

Why do xurl commands fail with 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 my-app, then xurl auth default my-app, and confirm with xurl auth status that the ▸ marker points to an app with oauth2 tokens.

Can the agent set up xurl credentials automatically?▼

No. App registration and OAuth authentication involve pasting secrets, so the user must run xurl auth apps add and xurl auth oauth2 manually outside the agent session. The agent may only verify credentials with xurl auth status.

Related Skills

Explore More Marketing & Sales Skills→
harlanljonesharlanljones

xurl

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

Community
Intermediate
gooseworks-aigooseworks-ai
1.1k

twitter-scraper

Retrieve and deduplicate Twitter/X posts matching a query with date filters.

Official
Intermediate
yoopta-editoryoopta-editor
3.1k

social-content

Generate and optimize platform-specific social content for LinkedIn, Twitter/X, Instagram, TikTok, and Facebook.

Official
Basic
portermetricsampleportermetricsample
17

meta-ads-account-safety

Enforce Meta Marketing API compliance for ad account automation.

Community
Advanced