xurl

Execute authenticated X API v2 requests via CLI and output JSON.

87|20|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/openaeon/OpenAEON --skill xurl-openaeon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/openaeon/OpenAEON/tree/main/skills/xurl
Command: npx skills add https://github.com/openaeon/OpenAEON --skill xurl-openaeon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually composing and sending authenticated HTTP requests to the X API for common social actions, so you can reliably perform posting, reading, and engagement tasks from an agent or terminal workflow.

Core Features & Use Cases

  • Authenticated X API access (CLI): Executes X API v2 requests using the user’s local credentials setup, returning JSON to stdout for easy automation.
  • High-level social actions: Supports posting, replying, quoting, deleting, searching, timelines, likes/reposts/bookmarks, and follower/DM operations.
  • Raw endpoint mode: Allows curl-style requests to any X API v2 endpoint, including streaming endpoints, when you need something beyond the shortcuts.

Quick Start

Run the xurl command to post a message: xurl post "Hello world!".

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I automate posting to X Twitter from the command line?

You can automate posting to X Twitter from the command line by running a CLI tool that executes authenticated X API v2 requests. It publishes content with optional media uploads and outputs JSON to stdout for easy downstream parsing.

How does a CLI tool handle authenticated requests to the X API without exposing secrets?

Authenticated requests to the X API are handled via pre-authenticated local credentials configured during setup. The CLI tool performs endpoint-scoped operations and raw curl-style requests internally without exposing your secrets in the terminal output.

Can I retrieve user timelines and mentions using the X API v2?

Yes, you can retrieve user timelines and mentions using the X API v2. The CLI tool supports querying timelines, mentions, and performing engagement actions like likes, reposts, and bookmarks, returning the results as JSON.

Do I need pre-authenticated local credentials to use an X API CLI for social media automation?

Yes, pre-authenticated local credentials are required to use an X API CLI for social media automation. You must run the authentication setup command first to enable the tool to securely access your account and perform actions like posting and searching.

What is the best way to query any X API v2 endpoint including streaming?

The best way to query any X API v2 endpoint including streaming is to use a CLI tool with a raw endpoint mode. This allows you to send curl-style requests to any available endpoint when you need functionality beyond standard high-level shortcuts.

Can I manage followers and direct messages through social media automation?

Yes, you can manage followers and direct messages through social media automation. The CLI tool supports follower operations, blocks, and messaging actions by executing the necessary authenticated X API v2 requests and returning JSON data.