xurl

Post, search, and message on X/Twitter via xurl CLI JSON outputs.

4|Updated May 18, 2026
One-click install
npx skills add https://github.com/ZardLi1115/zedclaw --skill xurl-zardli1115
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/ZardLi1115/zedclaw/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/ZardLi1115/zedclaw --skill xurl-zardli1115

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the hassle of manually interacting with the X/Twitter API by providing a consistent JSON-based command interface for publishing, reading, and messaging content.

Core Features & Use Cases

  • Post, Reply, Quote, and Delete: Create and manage tweets (including media-backed posts) without hand-crafting API calls.
  • Search and Timeline/Mentions Reading: Find relevant posts and monitor activity using JSON responses suitable for automation.
  • DM and Engagement Workflows: Send direct messages, list DMs, and perform engagement actions like like/repost/bookmark.

Quick Start

Tell the skill to post a new tweet from your authenticated account: xurl post "Hello from my agent!".

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I automate posting tweets on X without manually building API requests?

Automate posting tweets on X by using a CLI-based JSON interface to handle publishing, reading, and messaging. It eliminates manual API plumbing by providing deterministic JSON outputs for social posting, engagement, and DM workflows across OAuth2-authenticated accounts.

How do I retrieve timeline mentions and search results from Twitter as JSON?

Retrieve timeline mentions and search results from Twitter as JSON by executing search and timeline reading commands. The interface returns structured JSON responses suitable for automation, allowing you to find relevant posts and monitor account activity without hand-crafting API calls.

Do I need OAuth2 credentials stored locally to send direct messages on X?

Yes, you need OAuth2 credentials stored locally in the ~/.xurl directory to send direct messages on X. A locally configured xurl installation is required to authenticate accounts and execute DM workflows, engagement actions, and raw v2 endpoint calls.

Can I perform engagement actions like like, repost, and bookmark on Twitter programmatically?

Yes, you can perform engagement actions like like, repost, and bookmark on Twitter programmatically. The CLI supports DM and engagement workflows, enabling you to manage direct messages, list DMs, and execute social engagement actions through consistent JSON-based commands.

What is the best way to access raw Twitter v2 endpoints without manual API plumbing?

Access raw Twitter v2 endpoints without manual API plumbing by using a CLI that supports raw endpoint calls with deterministic JSON-to-stdout behavior. This approach bypasses manual request configuration by providing a consistent JSON-based command interface for the X/Twitter API.

Can I manage media-backed posts and replies on X using a command line interface?

Yes, you can manage media-backed posts and replies on X using a command line interface. The tool allows you to create, quote, reply to, and delete tweets, including posts with media attachments, by generating structured JSON outputs instead of hand-crafting API calls.