xurl

Access the X API from the command line with OAuth2, OAuth1, or app-only authentication.

1.3k|109|Updated Dec 14, 2024
One-click install
npx skills add https://github.com/xdevplatform/xurl --skill xurl-xdevplatform
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/xdevplatform/xurl/tree/main
Command: npx skills add https://github.com/xdevplatform/xurl --skill xurl-xdevplatform

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The xurl skill provides a command-line interface to interact with the X API securely with token storage and multi-app support, enabling authenticated requests to various v2 endpoints.

Core Features & Use Cases

  • Multi-app support and OAuth 2.0 / OAuth 1.0a / app-only authentication for X API access.
  • Shortcut commands and raw API access to post, read, search, like, follow, DM, media upload, and more.
  • Example scenario: You have multiple X accounts; switch default app and user to manage tweets and DMs efficiently.

Quick Start

Install xurl, configure your apps, then run a sample request such as xurl /2/users/me.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I make authenticated X API requests from the command line?

You can make authenticated X API requests from the command line using a curl-like CLI that manages token storage and supports OAuth 2.0, OAuth 1.0a, and app-only authentication. It provides shortcut commands and raw API access for posting, reading, searching, and managing DMs.

What is the best way to manage multiple X accounts with OAuth2 in a CLI?

The best way to manage multiple X accounts with OAuth2 in a CLI is using a tool with multi-app support that stores tokens locally. You can configure multiple apps and switch default users to efficiently manage tweets and DMs without re-authenticating.

Can I use curl to post tweets and upload media with OAuth2?

Yes, you can use an OAuth-enabled curl-like CLI to post tweets and upload media with OAuth2. It provides automatic token selection and shortcut commands for these actions, supporting secure access to various X API v2 endpoints.

Do I need a configuration file to access the X API from the terminal?

Yes, you need a configured ~/.xurl file to access the X API from the terminal. This configuration file stores your app credentials and OAuth tokens locally, enabling automatic token selection and multi-app support for your authenticated requests.

Does this CLI tool support OAuth1 and app-only authentication for searches?

Yes, the CLI tool supports OAuth1 and app-only authentication for searches. It handles token storage and automatic token selection across OAuth 2.0, OAuth 1.0a, and app-only modes for reading, searching, and posting via the X API.

When should I use raw API access instead of shortcut commands for X API requests?

You should use raw API access instead of shortcut commands for X API requests when you need direct endpoint flexibility beyond standard actions like posting or searching. The CLI provides both raw access and shortcuts, allowing automatic token selection for either method.