Goofish Search List

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.

1. navigate https://www.goofish.com/search?q={keyword}
2. wait stable
3. Proceed to DOM extraction below

Error handling: If the page shows a CAPTCHA slider ("Please slide to verify") instead of search results, the session has been rate-limited. Wait 5–10 minutes before retrying, or switch to a fresh browser session.

DOM: search result item cards (data extraction)

After navigating and waiting stable, extract all 30 item cards on the current page:

eval "$(python scripts/extract-search-items.py)"

Output example:

{
  "items": [
    {
      "item_id": "1054668718340",        // unique item ID
      "category_id": "126862528",        // category ID
      "item_url": "https://www.goofish.com/item?id=1054668718340&categoryId=126862528",
      "title": "美版iPhone 14 国行256G 纯原 原版原漆",  // full title text
      "image_url": "https://img.alicdn.com/bao/uploaded/...",  // thumbnail URL
      "price": "1810",                   // numeric string, CNY, no ¥ sign
      "service_tag": "Apple/苹果256GB无任何维修",  // condition/attribute tag or recency label, null if absent
      "price_desc": "2人想要",           // want-count or price-drop info, null if absent
      "location": "广东"                 // seller's location province/city
    }
  ],
  "count": 30
}

DOM: apply sort and filter options (operation)

Apply sort order, publish-date filter, or price range before extracting. Call before running extract-search-items.py. After calling, wait stable before extracting.

eval "$(python scripts/apply-search-filters.py --sort {sort} --publish-days {days} --price-min {min} --price-max {max})"

Parameters:

• --sort: Sort option — "" default (综合), "reduce" price-drop (新降价), "create" newest (新发布), "price-asc" price low-to-high, "price-desc" price high-to-low. Default: ""
• --publish-days: Filter by publish date — "" all, "1" within 1 day, "3" within 3 days, "7" within 7 days, "14" within 14 days. Default: ""
• --price-min: Minimum price (CNY integer string, e.g., "500"). Requires --price-max. Default: ""
• --price-max: Maximum price (CNY integer string, e.g., "3000"). Requires --price-min. Default: ""

Output example:

{
  "ok": true,
  "applied": {
    "sort": "reduce:desc",
    "searchFilter": "publishDays:7;priceRange:500,3000;"
  }
}

DOM: navigate to a specific page (operation)

eval "$(python scripts/goto-page.py {page_number})"

Parameters:

• page_number: Target page number (integer, 1-based)

Output example:

{ "ok": true, "clicked_page": 2 }

After clicking, wait stable then re-run extract-search-items.py to get the new page's items.

Enum Parameters

[AI] sort options: "" (综合/default), "reduce" (新降价), "create" (新发布/最新), "price-asc" (价格从低到高), "price-desc" (价格从高到低)

[AI] publish-days filter: "" (all), "1", "3", "7", "14"