skills.rest
AtlasOmnia
AtlasOmniaCOMMUNITY
Explore all skills by this author →
Website𝕏@AtlasOmniaGitHub

xurl

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

115|9|Updated Aug 5, 2026
Search Tags:#social media#cli#twitter#posting#oauth2#x api#xurl
One-click install
npx skills add https://github.com/AtlasOmnia/donna-starter --skill xurl-atlasomnia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/AtlasOmnia/donna-starter/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/AtlasOmnia/donna-starter --skill xurl-atlasomnia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing X (Twitter) activity from an agent session requires a safe, authenticated interface to the official X API without exposing credentials or juggling raw HTTP calls. This Skill wraps the xurl CLI so an agent can post, search, read, and engage on X while keeping OAuth tokens strictly out of the conversation. ## Core Features & Use Cases - Full X API coverage: Post, reply, quote, delete, search, read timelines and mentions, like, repost, bookmark, follow, block, mute, send DMs, and upload media — all returning structured JSON. - Raw v2 endpoint access: Run curl-style requests against any X API v2 endpoint, including streaming endpoints and X Articles via the article tweet field. - Strict secret safety: Mandatory rules prevent reading ~/.xurl, inline secret flags, or verbose mode inside agent sessions; all credential setup is done manually by the user. - Use Case: Ask the agent to search X for posts about your product launch, draft a reply to a mention, confirm the exact text with you, then post it with an attached image. ## Quick Start Ask the agent to check xurl auth status and then search X for the five most recent posts about a topic you care about.

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 text" after completing one-time OAuth setup. For media, upload first with xurl media upload photo.jpg, then attach it with xurl post "text" --media-id MEDIA_ID.

How do I search X posts using the official API?▼

Run xurl search "your query" -n 10 to get JSON results from the X API v2 search endpoint. Queries support operators like from:username, hashtags, and lang: filters.

Why does xurl show 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, then set it with xurl auth default your-app, and verify with xurl auth status.

Can xurl read X Articles and long-form posts?▼

Yes, but use raw API mode instead of the read shortcut: request the article tweet field via xurl '/2/tweets/ID?tweet.fields=article' and parse data.article.plain_text. For read-only cases, the fxtwitter or vxtwitter public APIs work as fallbacks.

Is it safe to use xurl inside an AI agent session?▼

Yes, if the safety rules are followed: never read ~/.xurl, never pass inline secret flags like --bearer-token or --client-secret, and never use --verbose. All credential registration and OAuth must be done manually by the user outside the agent.

Related Skills

Explore More Marketing & Sales Skills→
gqf2008gqf2008

xurl

Control X API v2 via the official xurl CLI for posting, reading, and searching.

Community
Advanced
vivy-yivivy-yi
363

performance-tracking

Analyzes social media performance metrics to inform content strategy.

Community
Advanced
anysiteioanysiteio
19

anysite-brand-reputation

Monitor brand mentions and sentiment across social platforms via anysite MCP server.

Official
Basic
AgenticAIPlanAgenticAIPlan
10

company-lookup

Retrieve verified Chinese company registration details from official sources.

Official
Intermediate