xurl

Perform authenticated requests to X API v2 endpoints from the CLI.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/liutao96/skill --skill xurl-liutao96
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/liutao96/skill/tree/main/xurl
Command: npx skills add https://github.com/liutao96/skill --skill xurl-liutao96

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables developers to perform authenticated requests to the X API directly from the command line, streamlining automation and scripting without exposing credentials in interactive sessions.

Core Features & Use Cases

  • Authenticated CLI access to X API v2 endpoints for posting, reading, searching, messaging, and media operations.
  • Shortcut and raw modes: supports human-friendly commands and raw curl-style access for advanced workflows.
  • Real-world use cases: automate posting updates, fetching user timelines, replying to conversations, and managing DMs in scripts or CI pipelines.

Quick Start

Run xurl to authenticate and perform a sample, authenticated request to X from your terminal.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I access the X API from the command line?▼

You can access the X API from the command line using the xurl CLI, which performs authenticated requests for posting tweets, searching, and reading timelines. Tokens are persisted locally to streamline scripting.

Can I automate posting tweets and sending DMs in a CI pipeline?▼

Yes, you can automate posting tweets and sending DMs in CI pipelines using xurl. It enables authenticated CLI access to X API v2 endpoints without exposing credentials during interactive sessions.

Do I need to manually pass API tokens when running X API scripts?▼

No, you do not need to manually pass API tokens for X API scripts. After authenticating once, xurl persists your tokens locally to the ~/.xurl file for subsequent automated requests.

What is the best way to make raw requests to custom X API v2 endpoints?▼

The best way to make raw requests to custom X API v2 endpoints is using xurl's raw mode. It supports curl-style general endpoint access for advanced workflows beyond the standard shortcut commands.

Does xurl support media uploads and fetching user timelines?▼

Yes, xurl supports media uploads and fetching user timelines. It provides authenticated CLI access across X API v2 endpoints for reading, searching, and managing media operations.

How do I get started with xurl for Twitter API automation?▼

To get started with Twitter API automation, run xurl to authenticate and perform a sample authenticated request directly from your terminal. This validates your setup for subsequent scripting tasks.