frankhuy/fishkeeper

Fishkeeper is a Python toolkit for managing a store on Xianyu, a Chinese second-hand marketplace operated by Alibaba. The project is written primarily in Chinese and is aimed at sellers or developers who want to automate store operations through Xianyu's open platform API rather than managing everything manually through the app. The toolkit is structured as a skill that can be loaded by AI agent frameworks. The README describes how to install it into several different AI coding environments: Hermes Agent (which is the primary target), Claude Code, OpenAI Codex CLI, Cursor, and any system that supports the Model Context Protocol. In each case the idea is the same: once the skill files are in place, the AI assistant can call the Xianyu API on behalf of the user when asked to do store-related tasks. The core functionality covers the full lifecycle of selling on Xianyu. On the product side it handles creating, editing, listing, delisting, and deleting items, including bulk operations. On the order side it handles querying orders, marking items as shipped, changing prices, and looking up card keys (which are used for digital goods). It also supports querying shipping companies and category or attribute lookups for setting up product listings correctly. Authentication to the Xianyu API uses MD5 signature signing, which is a common approach for Chinese open platform APIs. API credentials (an app key and an app secret) can be provided as environment variables or in a configuration file. The toolkit covers 19 API endpoints plus 3 webhook callback types for push notifications. The multi-agent orchestrator included in the project allows running several API calls in parallel, which is useful for operations like syncing inventory across a large catalog or batch-shipping multiple orders at once. The README is written for developers and assumes familiarity with Python and AI agent tooling.