Agent skill

Goofish Overview

by fancyboi999 in fancyboi999/goofish-cli

闲鱼(goofish.com)自动化运营的总入口 skill。何时激活:用户首次提到 闲鱼 / 咸鱼 / goofish / 二手交易 / 挂闲置 / 回买家消息 / 发商品到闲鱼, 或用户询问本工具如何使用、有哪些能力、能做什么。本 skill 介绍 goofish-cli 的定位、账号模型、17 个 MCP 工具速查、风控底线,并指向其它专项 skill…

Apache-2.0Auto-check passedAgent Workflows

Install Goofish Overview

skills CLI
$ npx skills add fancyboi999/goofish-cli --skill goofish-overview -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install fancyboi999/goofish-cli goofish-overview --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/fancyboi999/goofish-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/goofish-overview .claude/skills/goofish-overview && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
goofish-overview
GitHub stars
309
Token cost
~688 tokens
SKILL.md length
212 words
Files
4 (incl. references)
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

闲鱼(goofish.com)自动化运营的总入口 skill。何时激活:用户首次提到 闲鱼 / 咸鱼 / goofish / 二手交易 / 挂闲置 / 回买家消息 / 发商品到闲鱼, 或用户询问本工具如何使用、有哪些能力、能做什么。本 skill 介绍 goofish-cli 的定位、账号模型、17 个 MCP 工具速查、风控底线,并指向其它专项 skill…

  • Works in 4 steps: 任何写操作前先读 auth_status,避免 token 已过期却继续写 →… → item_publish / media_upload /… → 所有对外发送(发商品、发消息)务必让用户先确认文案,不要自动提交。 → …
  • Tasks that involve MCP servers
  • SKILL.md covers 这是什么, 工具命名, 四个专项 Skill 的分工 and 账号与登录态, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Goofish Overview is an agent skill from fancyboi999/goofish-cli. 闲鱼(goofish.com)自动化运营的总入口 skill。何时激活:用户首次提到 闲鱼 / 咸鱼 / goofish / 二手交易 / 挂闲置 / 回买家消息 / 发商品到闲鱼, 或用户询问本工具如何使用、有哪些能力、能做什么。本 skill 介绍 goofish-cli 的定位、账号模型、17 个 MCP 工具速查、风控底线,并指向其它专项 skill (goofish-publish-item / goofish-reply-buyer / goofish-risk-guard / goofish-shop-diagnosis)。

Its SKILL.md is about 690 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/accounts.md`, `references/mcp-tools-index.md` and `references/xianyu-concepts.md`).

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol and Python. The repository describes itself as: 闲鱼 CLI · 原生支持 MCP · 为 AI Agent 而生 | Goofish (Xianyu) automation CLI · MCP-ready · Built for AI Agents. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/goofish-overview”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 任何写操作前先读 auth_status,避免 token 已过期却继续写 → 白忙一场。
  2. item_publish / media_upload / message_send 都有速率限制(账号业务预算),不要短时间连发。RGV587 触发后需用户手动 goofish auth reset-guard。
  3. 所有对外发送(发商品、发消息)务必让用户先确认文案,不要自动提交。
  4. 多步任务中途报状态:上一步完成了什么、下一步准备做什么。闲鱼任务

What it can do on your machine

Read from SKILL.md and the folder at commit c2b397f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Goofish Overview loads about 688 tokens when it runs, and up to ~3.6k if it reads all its reference files. Until then it costs about 72 tokens; SKILL.md has 212 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~688
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from fancyboi999/goofish-cli at commit c2b397f, republished under its Apache-2.0 licence (© fancyboi999). 212 words, ~688 tokens.

Download SKILL.mdSave it as .claude/skills/goofish-overview/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
goofish-overview
description
闲鱼(goofish.com)自动化运营的总入口 skill。何时激活:用户首次提到 闲鱼 / 咸鱼 / goofish / 二手交易 / 挂闲置 / 回买家消息 / 发商品到闲鱼, 或用户询问本工具如何使用、有哪些能力、能做什么。本 skill 介绍 goofish-cli 的定位、账号模型、17 个 MCP 工具速查、风控底线,并指向其它专项 skill (goofish-publish-item / goofish-reply-buyer / goofish-risk-guard / goofish-shop-diagnosis)。
metadata.author
goofish-cli
metadata.version
0.3.0
metadata.tags
xianyu, goofish, overview, index

goofish-cli 总览

这是什么

goofish-cli 是一个 Python CLI + MCP server + Agent Skills 三合一工具包, 让 AI Agent 能像熟练卖家一样操作闲鱼:发商品、回消息、查风控、诊断店铺。

你(Agent)在 OpenClaw / Claude Code / Cursor 里通过 MCP 看到的工具,都来自同一个 goofish server(FastMCP("goofish"))。

工具命名

本文使用 registry 里的逻辑名(例如 auth_status)。实际调用时按宿主补前缀:

  • OpenClaw:goofish__auth_status
  • Claude Code / Cursor:mcp__goofish__auth_status

四个专项 Skill 的分工

遇到具体任务时,优先跳到对应专项 skill,不要在本 overview 里硬推断:

用户说激活的 skill
"帮我发布 / 上架 / 挂闲置"goofish-publish-item
"回复买家消息 / 看未读 / 议价"goofish-reply-buyer
"发布前检查 / 这话能说吗 / 风控 / 被限流怎么办"goofish-risk-guard
"我店铺怎么没流量 / 为什么曝光掉 / 诊断一下"goofish-shop-diagnosis

跨 skill 协作:发布 / 回消息前都应该先让 goofish-risk-guard 过一遍 (避免绝对化词、外联词)。这是个推荐 convention,不是硬强制。

账号与登录态

  • 登录态由 auth_status 检查,返回 {valid: bool}。
  • 自动刷新链路已内置(v0.2.2 - v0.2.4):token 过期自动续、session 过期 自动点 passport "快速进入"、浏览器免密失效需用户 goofish auth login --qr。
  • Agent 不应主动调 auth_login,这是敏感命令(会覆盖磁盘 cookie)。 只在 auth_status 返回 invalid 时提示用户手动 goofish auth login 或 goofish auth login --qr。
  • 账号身份细节见 references/accounts.md。

17 个 MCP 工具速查

详单在 references/mcp-tools-index.md。读不读看任务:

  • 发商品 → 只需 category_recommend / media_upload / location_default / item_publish
  • 回消息 → 只需 message_watch / message_list_chats / message_history / message_send
  • 诊断 → 只需 search_items / item_view / item_get
  • 登录态诊断 → auth_status
  • 下架/删除 → item_delete
  • skills 安装 → skills_install(辅助类工具,一般 Agent 不会直接调;由用户在终端跑)

例如 CLI 的 message list-chats 对应逻辑名 message_list_chats,调用时使用上面的宿主前缀。

合规硬红线(本工具禁止协助)

以下行为写在合规声明里且 skills 拒绝指导:

  • 刷单 / 虚假交易 / 伪造物流
  • 批量设备 ID 伪造 / 绕过滑块验证 / 规避封号
  • 针对闲鱼平台的 SaaS 化转售
  • 恶意评价 / 敲诈话术 / 外联引流(微信/VX/威信/V 信等)

若用户请求明显违反上述任一条,拒绝执行并解释原因,不要寻找绕过路径。

风控基础概念

详见 references/xianyu-concepts.md,这里只给 Agent 一个思维锚:

  • 闲气值:卖家信用分,< 80 开始限权(搜索曝光 -50% 起步)。
  • 流量池:每件新商品有 24 小时初始推荐窗口,错过不再有。
  • 降价改标:发布后先降价再改标题会触发"虚假促销",流量腰斩。
  • 外联词:微信 / 威信 / V信 / VX / +我 都命中,轻则降权重则封号。

工作流惯例

Agent 在 goofish 任务里请遵守:

  1. 任何写操作前先读 auth_status,避免 token 已过期却继续写 → 白忙一场。
  2. item_publish / media_upload / message_send 都有速率限制(账号业务预算),不要短时间连发。RGV587 触发后需用户手动 goofish auth reset-guard。
  3. 所有对外发送(发商品、发消息)务必让用户先确认文案,不要自动提交。
  4. 多步任务中途报状态:上一步完成了什么、下一步准备做什么。闲鱼任务 通常是 3-6 步,用户期望有进度感。

© fancyboi999, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/goofish-overview of fancyboi999/goofish-cli.

  • SKILL.md
  • references/accounts.md
  • references/mcp-tools-index.md
  • references/xianyu-concepts.md

Open the folder on GitHubat commit c2b397f

Compare with similar skills

Goofish Overview next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Goofish Overview compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Goofish Overview this skillfancyboi999/goofish-cli309—~688Automated safety check: PassApache-2.0
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k4 repos~1.2kAutomated safety check: PassMIT
MemPalace Setup and OperationMemPalace/mempalace59k—~2.2kAutomated safety check: PassMIT
FastmcpTommy-yw/RunbookHermes5463 repos~2.1kAutomated safety check: PassMIT
Fastmcp Client CLIPrefectHQ/fastmcp28k—~823Automated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 4 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Installs and configures MemPalace as a private local palace, a shared-brain hub or a client of an existing hub, including MCP registration and version-correct initialization.

    59k GitHub stars~2.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Fastmcp

    Tommy-yw/RunbookHermes

    Build, test, inspect, install, and deploy MCP servers with FastMCP in Python.

    546 GitHub starsUsed in 3 repos~2.1k tokens
    Agent WorkflowsAuto-check passed
  • Fastmcp Client CLI

    PrefectHQ/fastmcp

    Query and invoke tools on MCP servers using fastmcp list and fastmcp call.

    28k GitHub stars~823 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Migrate To Archestra

    archestra-ai/archestra

    Migrate an existing agentic PoC/pilot (Claude Code project files, MCP configs, hooks, local tools, openclaw config, or similar hand-rolled setup artifacts) into an Archestra instance.

    4.4k GitHub stars~2.5k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from fancyboi999/goofish-cli

  • Goofish Publish Item

    fancyboi999/goofish-cli

    闲鱼发商品 skill。何时激活:用户说"帮我发到闲鱼 / 挂个闲置 / 把 XX 上架 / 发布一件 / 新增商品 / 上新";或说"这个怎么写标题 / 类目该选啥 / 图片够了吗"。

    309 GitHub stars~928 tokensUpdated today
    Auto-check passed
  • Goofish Reply Buyer

    fancyboi999/goofish-cli

    闲鱼买家消息回复 skill。何时激活:用户说"看看我有没有未读 / 回复下买家 / 有人问 XX 怎么办 / 他要砍价我怎么办 / 帮我回一下消息 / 处理下催付 / 议价策略"。

    309 GitHub stars~805 tokensUpdated today
    Auto-check passed
  • Goofish Shop Diagnosis

    fancyboi999/goofish-cli

    闲鱼店铺 / 商品诊断 skill。何时激活:用户说"我店铺没流量 / 曝光掉了 / 怎么没人问 / 是不是被限流 / 帮我看看为啥没单 / 哪里出问题了"。功能: 用 searchitems 做"买家视角"查自家商品是否露出 → itemview 拉详情 对比排查 → 按归因清单给出"限流可能性 + 修复建议"。本 skill 纯读, 不做任何写操作——只诊断不修,修留给…

    309 GitHub stars~682 tokensUpdated today
    Auto-check passed
  • Goofish Risk Guard

    fancyboi999/goofish-cli

    闲鱼风控/合规预检 skill。何时激活:用户要发商品、回消息、降价改标前让你 "看看这样行不行"、"会不会违规"、"会不会封号"、"会不会限流";或用户说 "被限流了/曝光掉了怎么办";或被 goofish-publish-item / goofish-reply-buyer 调用做预检。功能:发布前扫描(绝对化词、类目偏差、降价改标、9 图合规), 发送前扫描(外联词、误导承诺),触发…

    309 GitHub stars~727 tokensUpdated today
    Auto-check passed

Categories

Questions about Goofish Overview

What does Goofish Overview do?

闲鱼(goofish.com)自动化运营的总入口 skill。何时激活:用户首次提到 闲鱼 / 咸鱼 / goofish / 二手交易 / 挂闲置 / 回买家消息 / 发商品到闲鱼, 或用户询问本工具如何使用、有哪些能力、能做什么。本 skill 介绍 goofish-cli 的定位、账号模型、17 个 MCP 工具速查、风控底线,并指向其它专项 skill…. Goofish Overview is an agent skill from fancyboi999/goofish-cli.

When should I use Goofish Overview?

Goofish Overview fits situations like: tasks that involve MCP servers.

How do I install Goofish Overview in Claude Code?

Run `npx skills add fancyboi999/goofish-cli --skill goofish-overview -a claude-code`. Or copy the skill folder (skills/goofish-overview in fancyboi999/goofish-cli) into .claude/skills/goofish-overview in your project. Claude Code loads it when a task matches its description.

How do I install Goofish Overview in Codex?

Run `npx skills add fancyboi999/goofish-cli --skill goofish-overview -a codex`. Or copy the skill folder (skills/goofish-overview in fancyboi999/goofish-cli) into .agents/skills/goofish-overview in your project. Codex loads it when a task matches its description.

Can I use Goofish Overview in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fancyboi999/goofish-cli --skill goofish-overview -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/goofish-overview, .gemini/skills/goofish-overview, .github/skills/goofish-overview and .opencode/skills/goofish-overview in your project.

What does Goofish Overview need to run?

SKILL.md names no scripts, command-line tools or credentials: Goofish Overview is instructions for the agent only. Our summary lists: Python 3.

Does Goofish Overview access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Goofish Overview safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Goofish Overview use?

Goofish Overview is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Goofish Overview use?

About 688 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.9k tokens, read only when the agent opens those files.

What are the alternatives to Goofish Overview?

Skills that share tags, products or a category with Goofish Overview: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MemPalace Setup and Operation (MemPalace/mempalace, 59k stars) and Fastmcp (Tommy-yw/RunbookHermes, 546 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Goofish Overview?

fancyboi999 (a GitHub user) maintains it in fancyboi999/goofish-cli, which has 309 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 10, 2026.

Source: fancyboi999/goofish-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.