A Playwright-powered CLI and npm package for interacting with X using browser session cookies instead of traditional API keys.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install frigatebird
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install frigatebird using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Frigatebird?
Frigatebird is a sophisticated developer tool that brings bird-style command ergonomics to X (formerly Twitter) via a Playwright-first architecture. It allows users to bypass the limitations and costs of official API keys by leveraging existing browser session cookies to perform complex actions directly from the command line. This skill is a cornerstone of the Openclaw Skills library for developers who need reliable, scriptable access to social media interactions.
By simulating real browser interactions, Frigatebird supports a wide range of activities from simple status updates to advanced list management and long-form article posting. It is designed for environment-agnostic use, supporting various browser profiles and providing structured JSON output for easy integration into larger automation pipelines.
Frigatebird Use Cases
- Automating bird-style CLI workflows for social media management.
- Posting tweets, replies, and premium articles programmatically without an API subscription.
- Bulk managing account lists through batch additions and removals.
- Scraping and searching timelines for research and data analysis within Openclaw Skills workflows.
How Frigatebird Works
- Authentication: The user provides session credentials via auth tokens or by pointing the tool to a local browser profile (Chrome or Firefox).
- Validation: The tool executes an identity check (whoami) to ensure the session is active and valid.
- Command Execution: Users issue commands for reading (search, home, thread) or writing (tweet, reply, article) data.
- Browser Emulation: Frigatebird utilizes Playwright to interact with the web UI, navigating pages and triggering UI elements as a human would.
- Data Output: Results are returned to the terminal, with optional JSON formatting for machine-readable consumption.
Frigatebird Setup
To start using this tool within the Openclaw Skills ecosystem, install it globally via npm:
npm install -g frigatebird
Alternatively, you can run commands directly using npx:
npx frigatebird whoami --auth-token YOUR_TOKEN --ct0 YOUR_CT0
Frigatebird Data Schema & Taxonomy
Frigatebird handles data through standard CLI arguments and produces structured outputs. The following table describes the primary data interfaces:
| Interface | Description |
|---|---|
| Input Arguments | Support for tweet text, URLs, list names, and file paths for batch processing. |
| JSON Output | Triggered by --json or --json-full for comprehensive metadata extraction. |
| Auth Flags | Handles --auth-token, --ct0, and browser profile paths. |
| Pagination | Uses --cursor, --max-pages, and --all for managing large datasets. |
Frigatebird Advanced Features
- Premium article support: Create long-form content using specialized browser cookie sources.
- High-volume list automation: Utilize batch commands with accounts.json files for efficient member management.
- Media integration: Attach images with custom alt-text directly from the CLI.
- Deterministic testing: Use flags like --plain and --no-color for cleaner logs in CI/CD environments.
- Granular paging: Fine-tune data retrieval with custom delays and cursor-based navigation for Openclaw Skills developers.
SKILL.md
Loading
Related Openclaw Skills
AgentFinObs
AgentFinObs is a comprehensive financial observability framework for monitoring, budgeting, and analyzing AI agent spending across multiple payment rails.
YNAB CLI Manager
A comprehensive command-line interface for managing You Need A Budget (YNAB) data, including budgets, categories, and transactions.
OpenRouter Audio Transcription
A robust CLI tool for transcribing audio files using state-of-the-art LLMs via the OpenRouter API.
WOL and Sleep PC Control
A specialized skill for sending Wake-on-LAN and Sleep-on-LAN magic packets to manage PC power states across a local network.
NotebookLM CLI
A comprehensive command-line interface for managing Google NotebookLM notebooks, sources, and AI-generated media like podcasts and reports.
DX Terminal Pro
An advanced management interface for AI agents specialized in autonomous memecoin trading and vault optimization.
Featured*
