skills.rest
srgaba
srgabaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

xurl

Executes authenticated X API v2 requests for posting, searching, and managing social interactions.

Updated Mar 30, 2026
Search Tags:#automation#social media#oauth#cli#twitter#tweets#x api
One-click install
npx skills add https://github.com/srgaba/open-claw --skill xurl-srgaba
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/srgaba/open-claw/tree/main/project/skills/xurl
Command: npx skills add https://github.com/srgaba/open-claw --skill xurl-srgaba

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires xurl.

What problem does it solve? Interacting with the X (Twitter) API requires handling OAuth authentication, endpoint URLs, and JSON payloads manually, which is slow and error-prone. This Skill wraps the xurl CLI so you can post, search, reply, follow, and manage your X presence with simple one-line commands that return structured JSON. ## Core Features & Use Cases - Posting & Engagement: Post tweets, replies, and quotes, upload media, like, repost, and bookmark posts directly from the command line. - Reading & Search: Read individual posts, search recent posts, view timelines, mentions, bookmarks, and likes with JSON output. - Social Graph & DMs: Follow, unfollow, block, mute, list followers, and send direct messages. - Raw API Access: Call any X API v2 endpoint with curl-style syntax, including streaming endpoints. - Use Case: Search for posts about your product launch, like the most relevant ones, reply to a customer question, and post an announcement with an attached image — all without leaving your terminal. ## Quick Start Ask the agent to check authentication with xurl auth status and then post a tweet saying hello to your followers.

Frequently Asked Questions about xurl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I post a tweet from the command line?▼

Use the xurl CLI with the command xurl post "your message" after authenticating with xurl auth oauth2. To attach media, first run xurl media upload with your file, then pass the returned media ID via the --media-id flag.

How do I search tweets using the X API v2?▼

Run xurl search "your query" -n 10 to search recent posts through the X API v2 search endpoint. The command supports standard X search operators like from:, hashtags, and lang: filters, and returns results as JSON.

How do I authenticate xurl with the X API?▼

Register your app credentials manually in the ~/.xurl file outside any agent session, then run xurl auth oauth2 to authenticate. Verify your setup anytime with xurl auth status, and never pass tokens or secrets as inline command flags.

Can xurl access any X API endpoint or only preset commands?▼

xurl supports raw curl-style access to any X API v2 endpoint, for example xurl /2/users/me or xurl -X POST /2/tweets -d '{"text":"hi"}'. Streaming endpoints like /2/tweets/search/stream are auto-detected or forced with the -s flag.

Why does xurl return a 429 or 403 error?▼

A 429 error means you hit an X API rate limit, so wait and retry, especially on write endpoints which have stricter limits. A 403 error usually means your OAuth token lacks the required scope, so re-run xurl auth oauth2 to get a fresh token.

Related Skills

Explore More Marketing & Sales Skills→
tray-tecnologiatray-tecnologia
14

tray-autorizacao

Manage OAuth 2.0 token lifecycle for Tray API access.

Official
Intermediate
browser-actbrowser-act
5.5k

threads-keyword-search

Extract Threads keyword and hashtag search results with engagement metrics from SSR-embedded JSON.

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
J-StaR-Films-StudiosJ-StaR-Films-Studios
23

twitter-automation

Automate Twitter/X posting, engagement, and user management via the inference.sh CLI.

Official
Intermediate