xurl

Automate X posts, searches, DMs, and media via the xurl CLI.

2|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/john-data-chen/hermes-agent-backup --skill xurl-john-data-chen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/john-data-chen/hermes-agent-backup/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/john-data-chen/hermes-agent-backup --skill xurl-john-data-chen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The xurl skill provides a command-line interface to X's API, letting you perform routine actions such as posting, reading timelines, sending direct messages, and uploading media without leaving your terminal.

Core Features & Use Cases

  • CLI-first X API access: Post, search, like, repost, DM, and media uploads using a single tool.
  • Multi-account workflows: Manage multiple X apps and accounts with per-app credentials and a default app.
  • Automation-friendly outputs: JSON-formatted responses suitable for scripting and integration.

Quick Start

Install xurl, configure OAuth2, and perform your first post to validate the setup.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I automate posting and searching on X from the command line?

Automate X interactions from the command line using the xurl CLI to perform posts, searches, direct messages, and media uploads. It outputs JSON-formatted responses suitable for scripting and integration into automation workflows.

How does CLI-driven social media automation handle multiple X accounts?

CLI-driven social media automation handles multiple X accounts by using per-app OAuth 2.0 PKCE credentials. You can configure a default app while managing distinct credentials for separate X apps and accounts.

Do I need OAuth 2.0 PKCE credentials to use the xurl CLI for X automation?

Yes, you need OAuth 2.0 PKCE credentials with per-app configuration to authenticate the xurl CLI. This security protocol is required to authorize actions like posting, reading timelines, and messaging.

Can I run xurl for CLI-driven X API access on Windows?

No, you cannot run xurl on Windows. CLI-driven X API access via xurl requires the tool to be installed on a Linux or macOS operating system environment.

What is the best way to parse X API responses for automation scripts?

The best way to parse X API responses for automation scripts is leveraging the JSON-formatted outputs provided by the xurl CLI. These structured responses allow seamless integration when automating posts, searches, and DMs.

What are the limitations of using xurl for X API automation?

Limitations of using xurl for X API automation include its strict dependency on Linux or macOS environments and the requirement for per-app OAuth 2.0 PKCE credentials, preventing immediate use without prior authentication setup.