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.