frigatebird

What This Skill Does

The Frigatebird skill integrates the powerful frigatebird npm package into OpenClaw, enabling programmatic interaction with X (formerly Twitter) using Playwright-based browser automation. Unlike standard API-reliant tools, Frigatebird uses your existing browser session cookies to replicate human-like interactions on the X web UI. This allows for full-featured posting, replies, article creation, and comprehensive list management without the need for expensive or restrictive X API keys. It maintains compatibility with traditional 'bird' CLI ergonomics, making it a drop-in replacement for power users and automation engineers.

Installation

To integrate this skill, run the following command in your OpenClaw environment: clawhub install openclaw/skills/skills/oceanswave/frigatebird For CLI-specific local usage outside of the agent context, you can install the underlying package globally via npm install -g frigatebird or use npx frigatebird for quick, ad-hoc tasks.

Use Cases

• Social Media Automation: Schedule or broadcast updates, perform automated follow/unfollow actions, and manage lists at scale.
• Data Scraping & Analysis: Extract timeline data, search results, or thread content directly into JSON format for downstream processing in your AI pipelines.
• CLI-Centric Workflow: If you prefer a terminal-first environment over the X web interface, this skill bridges the gap, allowing you to tweet, reply, or draft articles without leaving your shell.
• List Management: Bulk-add or remove accounts from custom lists, helping to curate your feed without manual clicks.

Example Prompts

1. "Use frigatebird to search for '#AI' tweets from the last 24 hours and export the results to a JSON file."
2. "Add @openclaw_dev and @oceanswave to my 'Engineering' list using the frigatebird skill."
3. "Draft a new article titled 'Future of AI' with the content 'AI agents are changing everything' using my existing browser session."

Tips & Limitations

• Selector Drift: Because Frigatebird interacts with the X web UI, it is susceptible to DOM changes. If the site layout updates, the skill may require an update to maintain functionality.
• Auth Persistence: Ensure your browser cookies are fresh. Use frigatebird check or frigatebird whoami to verify that your session is active before running heavy automation batches.
• Pagination: Use flags like --all or --max-pages when querying large timelines to prevent overloading the browser instance or hitting rate limits.
• Premium Features: If you are using advanced features like article publishing, ensure you are providing the correct --article-cookie-source path to your profile data.