# Goofish Search List

Scrapes second-hand item search results from Goofish (闲鱼/xianyu, goofish.com), China's...

- Repository: https://github.com/browser-act/skills (6303 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-08-24
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add browser-act/skills --skill goofish-search-list -g -a claude-code -y`
Codex: `npx skills add browser-act/skills --skill goofish-search-list -g -a codex -y`
Cursor: `npx skills add browser-act/skills --skill goofish-search-list -g -a cursor -y`
Gemini CLI: `npx skills add browser-act/skills --skill goofish-search-list -g -a gemini-cli -y`

## Description

Scrapes second-hand item search results from Goofish (闲鱼/xianyu, goofish.com), China's largest second-hand marketplace. Input: keyword, optional sort/filter params. Output: list of items with id, title, price, image, location, want-count per page (30 items/page). Use when user mentions goofish, 闲鱼, xianyu, 二手交易, second-hand marketplace China, 二手商品搜索, search used goods, scrape goofish listings, xianyu search results, collect second-hand prices, monitor used item prices, 闲鱼关键词搜索, 闲鱼数据采集, 批量抓取闲鱼, goofish scraper, goofish data, xianyu data extraction, 二手商品价格监控, used iPhone prices, 二手手机价格. Also applies to: price research on Chinese second-hand market, competitor product monitoring via used goods listings, inventory analysis.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Goofish (闲鱼), Search Results List

> keyword + optional filters → list of 30 second-hand item cards per page (id, title, price, image, location, want-count)

## Language

All process output to user (progress updates, process notifications) follows the user's language.

## Objective

Extract second-hand item listing cards from Goofish keyword search results, supporting sort options, price range filters, and publish-date filters, with page-by-page pagination.

## Prerequisites

- Browser with an active Goofish session (logged-in account recommended for full results)
- Target page is already open or will be opened: `https://www.goofish.com/search?q={keyword}`

## Pre-execution Checks

### 1. Tool Readiness

If browser-act has been confirmed available in the current session → skip this step.

Invoke `browser-act` via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.

### 2. Login Verification

If login status for Goofish has been confirmed in the current session → skip this step.

Otherwise: open `https://www.goofish.com/` and observe the page:
- User avatar or account entry exists → logged in, continue
- Login/register prompt → not logged in; inform user that login may be required for full results; assist login if needed

## Capability Components

> This Skill's operational boundary = what the user can manually do in their browser. It only reads data already displayed to the user on the page. JS code is encapsulated in Python files under the `scripts/` directory, invoked via `eval "$(python scripts/xxx.py {params})"`. `$(...)` is bash syntax; it is recommended to use the bash tool for execution.

### Network Capture: trigger search and load results

Search requests use a dynamic `sign` token computed client-side, they cannot be reconstructed directly. Navigate to the search URL to trigger the API automatically.

The rest: https://github.com/browser-act/skills/blob/HEAD/solutions/ecommerce/goofish-search-list/SKILL.md