XURL

Name: XURL
Availability: InStock
Author: Agent Smith

by Agent Smith v1.0.0

The `xurl` CLI provides a comprehensive interface for interacting with the X (formerly Twitter) API. It supports a wide range of authenticated operations, including posting tweets, managing replies, quotes, and deletions, reading timelines, searching, and handling direct messages. Users can also manage media uploads, follow/unfollow users, and control their X account's authentication status.

Beyond common shortcuts, `xurl` offers a powerful raw mode for making direct calls to any X v2 API endpoint, allowing for maximum flexibility. It emphasizes secure handling of authentication secrets and provides clear guidance on output formats and error handling, making it an essential tool for developers and automated systems working with the X platform.

x twitter cli api social media automation posts dms media search

What It Does

The `xurl` skill enables AI agents to programmatically interact with the X (formerly Twitter) API. It allows for a wide array of actions such as creating and managing posts, handling direct messages, uploading media, searching for content, managing followers, and checking authentication status. It also provides a raw API mode for direct interaction with any X v2 endpoint, offering full control over the platform's capabilities.

When To Use

Use `xurl` when an AI agent needs to automate interactions with the X platform, such as posting updates, replying to mentions, sending direct messages, retrieving user timelines, performing content searches, or managing media. It's ideal for building social media automation tools, content syndication services, or data collection agents that require authenticated access to X.

Inputs

Text content for posts/DMs, X post IDs, user handles (@handle), search queries, media file paths (images/videos), raw X API v2 endpoint paths, HTTP methods (GET, POST), and JSON payloads for raw API calls.

Outputs

JSON objects on successful API calls, non-zero exit codes on errors, and status messages for media uploads.

Limitations

Requires careful handling of authentication secrets; avoid exposing `~/.xurl` or using `--verbose` in agent sessions.
Subject to X API rate limits (429 errors), requiring back-off strategies.
Media uploads may require polling `media status` for processing completion.
Authentication failures (401/403 errors) often indicate scope or app mismatch, requiring `xurl auth status` checks.