cv-cat/catbus

What it solves

Managing data and interactions across multiple social media and web platforms is difficult because each site has unique APIs, authentication methods, and data formats. This project provides a unified command-line interface to interact with 11 major platforms (such as Xiaohongshu, Douyin, Bilibili, and X) using a single, consistent syntax.

How it works

It acts as a standardized wrapper that translates common commands—like searching, posting, or retrieving user data—into the specific API calls required by each platform. It handles complex tasks like browser-level TLS/HTTP2 fingerprinting, request signing, and automated captcha solving (using local ONNX/OpenCV models) to mimic legitimate user behavior. All output is returned in a consistent JSON format, making it easy for scripts or AI agents to process data across different services.

Who it’s for

This tool is designed for developers, data researchers, and AI agent builders who need to automate interactions with social media platforms or aggregate data from them without writing custom integration code for every single site.

Highlights

• Unified API: Use the same commands and parameters across 11 different platforms.
• Agent-Ready: Designed for AI agents with self-describing commands, stable error codes, and built-in skill definitions for tools like Claude Code.
• Privacy-Focused: Authentication credentials are stored locally on the user's machine, and the tool does not collect or upload user data.
• Robust Implementation: Includes over 560 data-matching tests and 940 offline tests to ensure requests remain consistent with platform requirements.