xurl

Interact with the X/Twitter API v2 via a curl-like CLI wrapper.

28|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/ma08/botfiles --skill xurl-ma08
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/ma08/botfiles/tree/main/claude/skills/xurl
Command: npx skills add https://github.com/ma08/botfiles --skill xurl-ma08

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the friction and security risks of working directly with the X/Twitter API, removing the need to manually manage raw endpoints, authentication flows, and sensitive credentials when interacting with the platform.

Core Features & Use Cases

  • Safe X API Access: Provides a curl-like CLI wrapper for all X API v2 endpoints, with strict guardrails to prevent accidental credential exposure and mandatory approval for all write/social actions.
  • Full Platform Coverage: Supports read actions like searching posts, checking timelines, inspecting user profiles, and reviewing mentions, as well as approved write actions including posting, replying, following users, and uploading media.
  • Use Case: If you need to search for recent posts about a trending topic, reply to a specific post, or check your follower list, this Skill handles all API calls safely without you needing to manage authentication or raw endpoint syntax.

Quick Start

Use the xurl skill to search for the 10 most recent posts about your chosen topic and display the results to you.

Frequently Asked Questions about xurl

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

FAQPage Schema
How do I securely access the X Twitter API without exposing my credentials?

You can securely access the X Twitter API using a curl-like CLI wrapper that protects your credentials with strict guardrails. This approach manages authentication flows automatically to prevent accidental credential exposure when interacting with the platform.

How do I search recent posts and timelines using the X API v2?

You can search recent posts and timelines using X API v2 by utilizing shortcut commands for reading actions. This allows you to search posts, check timelines, inspect user profiles, and review mentions without managing raw endpoint syntax.

Do I need manual approval to post content or follow users on X?

Yes, mandatory approval is required for all write and social actions on X, including posting content, replying, following users, and uploading media. This guardrail prevents unintended social engagement actions via the authenticated API.

Can I use raw endpoint access with X API v2 instead of shortcut commands?

Yes, you can use raw endpoint access with X API v2 alongside shortcut commands. The CLI wrapper supports both methods, allowing direct interaction with specific endpoints while maintaining the same credential protection and authentication management.

What is the best way to manage social graph actions like checking my follower list?

The best way to manage social graph actions like checking your follower list is using an authenticated API wrapper with built-in guardrails. It safely handles social graph queries and other read actions without requiring manual endpoint configuration.