<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: unitbytes</title>
    <description>The latest articles on DEV Community by unitbytes (@unitbytes).</description>
    <link>https://dev.to/unitbytes</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4234530%2Fbe904008-166a-45b4-8842-3efd4b984375.png</url>
      <title>DEV Community: unitbytes</title>
      <link>https://dev.to/unitbytes</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/unitbytes"/>
    <language>en</language>
    <item>
      <title>How to Scrape Goofish (Xianyu / 闲鱼) in 2026 Without +86 Login or Cookies (Python SDK + MCP)</title>
      <dc:creator>unitbytes</dc:creator>
      <pubDate>Mon, 16 Nov 2026 14:24:57 +0000</pubDate>
      <link>https://dev.to/unitbytes/how-to-scrape-goofish-xianyu-xian-yu-in-2026-without-86-login-or-cookies-python-sdk-mcp-a17</link>
      <guid>https://dev.to/unitbytes/how-to-scrape-goofish-xianyu-xian-yu-in-2026-without-86-login-or-cookies-python-sdk-mcp-a17</guid>
      <description>&lt;p&gt;&lt;strong&gt;Goofish (&lt;code&gt;闲鱼&lt;/code&gt; / Xianyu)&lt;/strong&gt; is Alibaba's flagship C2C recommerce marketplace — processing over &lt;strong&gt;100M+ monthly active buyers&lt;/strong&gt; across vintage mirrorless cameras, PC GPUs, retro handhelds, road bikes, luxury handbags, and anime/ACG collectibles (&lt;em&gt;guzi&lt;/em&gt; / &lt;code&gt;谷子&lt;/code&gt;). Because individual Chinese sellers price used gear for fast domestic turnover, street prices on Goofish routinely sit &lt;strong&gt;20%–45% below eBay, Reverb, Mercari JP, or Chrono24&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;Yet if you have ever tried building a Python deal monitor, price-comp dataset, or AI shopping agent for Goofish from outside mainland China, you hit four immediate engineering walls:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Ephemeral Request Signing &amp;amp; Session Tokens&lt;/strong&gt;: Goofish's web and mobile endpoints require short-lived cryptographic request signatures paired with rotating session tokens that expire rapidly.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Alipay / +86 Real-Name Login Walls&lt;/strong&gt;: Unauthenticated keyword search and seller-profile requests on standard web views immediately hit a mandatory Taobao/Alipay QR login gate requiring mainland +86 SMS or passport KYC verification.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Aggressive Datacenter Anti-Bot Filtering&lt;/strong&gt;: Standard cloud IPs (AWS, GCP, GitHub Actions, Hetzner) are immediately blocked or challenged with interactive verification sliders.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Opaque &lt;code&gt;m.tb.cn&lt;/code&gt; Share Snippets &amp;amp; Slang&lt;/strong&gt;: Sellers share links as raw mobile text (&lt;code&gt;【闲鱼】https://m.tb.cn/h.xxxx 点击链接直接打开&lt;/code&gt;), and listings use domain-specific Chinese shorthand (&lt;code&gt;箱说全&lt;/code&gt; = full box &amp;amp; papers, &lt;code&gt;无拆无修&lt;/code&gt; = unopened/unrepaired, &lt;code&gt;个人闲置&lt;/code&gt; = personal seller, &lt;code&gt;吧唧&lt;/code&gt; = anime tin badge) that literal English keyword searches miss completely.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;In this guide, we will walk through how to query live Goofish listings, resolve &lt;code&gt;m.tb.cn&lt;/code&gt; share links, compute CNY-to-USD markdowns, generate 1-click &lt;strong&gt;Superbuy / AllChinaBuy&lt;/strong&gt; proxy checkout links, and audit seller &lt;strong&gt;Zhima Credit (&lt;code&gt;芝麻信用&lt;/code&gt;)&lt;/strong&gt; &amp;amp; buyer reviews using the open-source &lt;strong&gt;&lt;code&gt;goofish-xianyu-api&lt;/code&gt;&lt;/strong&gt; Python SDK and &lt;strong&gt;&lt;code&gt;goofish-xianyu-mcp&lt;/code&gt;&lt;/strong&gt; Model Context Protocol server — with &lt;strong&gt;zero Taobao/Alipay cookies&lt;/strong&gt;.&lt;/p&gt;




&lt;h2&gt;
  
  
  Architecture &amp;amp; Realistic Capabilities
&lt;/h2&gt;

&lt;p&gt;Instead of maintaining brittle local Playwright browsers, +86 SIM cards, and residential proxy pools, &lt;code&gt;goofish-xianyu-api&lt;/code&gt; (zero third-party Python dependencies) and &lt;code&gt;goofish-xianyu-mcp&lt;/code&gt; expose a typed client + local helpers (offline English-to-Chinese Xianyu slang glossary, &lt;code&gt;itemId&lt;/code&gt; watchlist state deduplication, CNY-to-USD markdown math, and Zhima Credit scoring) backed by cloud HTTP endpoints:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Module / Tool&lt;/th&gt;
&lt;th&gt;Package&lt;/th&gt;
&lt;th&gt;Key Capabilities&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;GoofishClient.search_items&lt;/code&gt; / &lt;code&gt;search_many&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;&lt;a href="https://pypi.org/project/goofish-xianyu-api/" rel="noopener noreferrer"&gt;&lt;code&gt;goofish-xianyu-api&lt;/code&gt;&lt;/a&gt;&lt;/td&gt;
&lt;td&gt;Single &amp;amp; multi-keyword search, cross-keyword &lt;code&gt;itemId&lt;/code&gt; dedup, auto-pagination, &lt;code&gt;only_new&lt;/code&gt; state file&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;GoofishClient.get_item_detail&lt;/code&gt; / &lt;code&gt;get_seller_*&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;&lt;a href="https://pypi.org/project/goofish-xianyu-api/" rel="noopener noreferrer"&gt;&lt;code&gt;goofish-xianyu-api&lt;/code&gt;&lt;/a&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;m.tb.cn&lt;/code&gt; share-link resolution, seller Zhima Credit &amp;amp; KYC badges, &lt;code&gt;onsale&lt;/code&gt;/&lt;code&gt;sold&lt;/code&gt; comps, buyer reviews&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;search_goofish_items&lt;/code&gt; &amp;amp; 4 Seller/Item MCP Tools&lt;/td&gt;
&lt;td&gt;&lt;a href="https://www.npmjs.com/package/goofish-xianyu-mcp" rel="noopener noreferrer"&gt;&lt;code&gt;goofish-xianyu-mcp&lt;/code&gt;&lt;/a&gt;&lt;/td&gt;
&lt;td&gt;Native stdio MCP server for Claude Desktop, Cursor, Windsurf, and VS Code&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h3&gt;
  
  
  What Works Without Login vs. Platform Boundaries
&lt;/h3&gt;

&lt;p&gt;Before writing code, it helps to separate what public guest extraction reliably delivers from what requires a personal mobile app session:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Works Reliably Without Cookies&lt;/strong&gt;:

&lt;ul&gt;
&lt;li&gt;Live keyword search with CNY &lt;code&gt;price_min&lt;/code&gt; / &lt;code&gt;price_max&lt;/code&gt;, &lt;code&gt;personal_only&lt;/code&gt; (&lt;code&gt;个人闲置&lt;/code&gt;), &lt;code&gt;free_shipping&lt;/code&gt; (&lt;code&gt;包邮&lt;/code&gt;), sort order (&lt;code&gt;newest&lt;/code&gt;, &lt;code&gt;price_asc&lt;/code&gt;, &lt;code&gt;priceDrop&lt;/code&gt;, &lt;code&gt;credit&lt;/code&gt;), and city region filters.&lt;/li&gt;
&lt;li&gt;Multi-page Standby auto-pagination (&lt;code&gt;30&lt;/code&gt; items/page up to &lt;code&gt;150&lt;/code&gt; items synchronously, or up to &lt;code&gt;1,500&lt;/code&gt; items via batch fallback).&lt;/li&gt;
&lt;li&gt;Full item detail resolution (description, HD image gallery, specs dictionary, &lt;code&gt;wants&lt;/code&gt; count, city, condition tag) from numeric IDs, &lt;code&gt;goofish.com&lt;/code&gt; URLs, or raw &lt;code&gt;m.tb.cn&lt;/code&gt; mobile share text.&lt;/li&gt;
&lt;li&gt;Seller &lt;strong&gt;Zhima Credit (&lt;code&gt;芝麻信用&lt;/code&gt;)&lt;/strong&gt; tiers (&lt;code&gt;极好&lt;/code&gt;, &lt;code&gt;优秀&lt;/code&gt;, &lt;code&gt;良好&lt;/code&gt;, &lt;code&gt;中等&lt;/code&gt;, &lt;code&gt;较差&lt;/code&gt;), biometric KYC verification badges (&lt;code&gt;实人认证&lt;/code&gt;, &lt;code&gt;实名认证&lt;/code&gt;), active &lt;code&gt;onsale&lt;/code&gt; and historical &lt;code&gt;sold&lt;/code&gt; catalogs, and paginated buyer feedback reviews (&lt;code&gt;all&lt;/code&gt;, &lt;code&gt;negative_only&lt;/code&gt;, &lt;code&gt;with_photos&lt;/code&gt;).&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Upstream Platform Boundaries&lt;/strong&gt;:

&lt;ul&gt;
&lt;li&gt;Private buyer-seller DM chat messages, unmasked seller phone/Alipay identifiers, and direct order placement require an authenticated personal Goofish app account (or a cross-border purchasing agent such as Superbuy or AllChinaBuy).&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  Step 1: Configure Your API Environment Variable
&lt;/h2&gt;

&lt;p&gt;Both &lt;code&gt;goofish-xianyu-api&lt;/code&gt; and &lt;code&gt;goofish-xianyu-mcp&lt;/code&gt; auto-detect credentials from your environment (&lt;code&gt;APIFY_TOKEN&lt;/code&gt;, &lt;code&gt;UNITBYTES_API_KEY&lt;/code&gt;, or &lt;code&gt;RAPIDAPI_KEY&lt;/code&gt;; see package READMEs for token setup):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="kd"&gt;export&lt;/span&gt; &lt;span class="nv"&gt;APIFY_TOKEN&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"apify_api_YOUR_TOKEN"&lt;/span&gt;
&lt;span class="c"&gt;# Also supports UNITBYTES_API_KEY or RAPIDAPI_KEY automatically&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  Step 2: Multi-Keyword Watchlist Sniper in Python (&lt;code&gt;goofish-xianyu-api&lt;/code&gt;)
&lt;/h2&gt;

&lt;p&gt;Install the typed Python SDK (Python 3.10+):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;pip install goofish-xianyu-api
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Offline English → Xianyu Slang Translation + Deduplicated Watchlist
&lt;/h3&gt;

&lt;p&gt;&lt;code&gt;goofish-xianyu-api&lt;/code&gt; ships with a curated offline English-to-Simplified-Chinese Xianyu glossary (&lt;code&gt;translate_keyword&lt;/code&gt;, zero LLM calls), cross-keyword &lt;code&gt;itemId&lt;/code&gt; deduplication (&lt;code&gt;search_many&lt;/code&gt;), atomic local state persistence (&lt;code&gt;only_new=True&lt;/code&gt;), and proxy-agent URL builders (&lt;code&gt;build_proxy_agent_links&lt;/code&gt;):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="n"&gt;goofish_xianyu_api&lt;/span&gt; &lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="nc"&gt;GoofishClient&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;analyze_resale_pricing&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;build_proxy_agent_links&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;translate_keyword&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="c1"&gt;# 1. Offline glossary preserves model numbers while translating Xianyu slang&lt;/span&gt;
&lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;translate_keyword&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"Sony A7C2 mirrorless camera box and papers"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="c1"&gt;# -&amp;gt; "索尼 A7C2 微单相机 箱说全"&lt;/span&gt;
&lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;translate_keyword&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"Genshin Impact badge unopened"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="c1"&gt;# -&amp;gt; "原神 吧唧 全新未拆封"&lt;/span&gt;

&lt;span class="n"&gt;client&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;GoofishClient&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;  &lt;span class="c1"&gt;# Reads APIFY_TOKEN from environment&lt;/span&gt;

&lt;span class="c1"&gt;# 2. Multi-keyword watchlist sniper (auto-paginates &amp;gt;30 items &amp;amp; deduplicates itemIds)&lt;/span&gt;
&lt;span class="n"&gt;unseen_deals&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;search_many&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="s2"&gt;"Sony A7C2 mirrorless"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="s2"&gt;"Fujifilm X100VI box and papers"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="s2"&gt;"Nintendo Switch OLED"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;max_items&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;45&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;translate_keywords&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="kc"&gt;True&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;personal_only&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="kc"&gt;True&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;       &lt;span class="c1"&gt;# Exclude commercial storefronts (个人闲置)&lt;/span&gt;
    &lt;span class="n"&gt;free_shipping&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="kc"&gt;True&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;price_min&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;900&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;price_max&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;13500&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;sort_by&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"newest"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;only_new&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="kc"&gt;True&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;            &lt;span class="c1"&gt;# Persist seen item IDs so cron runs emit only new drops&lt;/span&gt;
    &lt;span class="n"&gt;state_file&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"watchlist_seen.json"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;item&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;unseen_deals&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="mi"&gt;5&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;pricing&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;analyze_resale_pricing&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;item&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;cny_to_usd&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mf"&gt;0.138&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;links&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;build_proxy_agent_links&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;item&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"[{item.get('matchedKeyword')}] {item['title']}\n"&lt;/span&gt;
        &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"  Price: ¥{pricing.price_cny} (${pricing.price_usd}) | "&lt;/span&gt;
        &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"Markdown: -{pricing.discount_pct}% | Condition: {pricing.condition_normalized}\n"&lt;/span&gt;
        &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"  Superbuy:    {links.superbuy}\n"&lt;/span&gt;
        &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"  AllChinaBuy: {links.allchinabuy}"&lt;/span&gt;
    &lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  Step 3: Vet Seller Zhima Credit, Sold Comps &amp;amp; Negative Buyer Reviews
&lt;/h2&gt;

&lt;p&gt;Cheap electronics or luxury pieces on C2C marketplaces require seller vetting before you submit an agent order. You can score a seller's &lt;strong&gt;Zhima Credit (&lt;code&gt;芝麻信用&lt;/code&gt;)&lt;/strong&gt;, biometric KYC verification, historical sold count, and negative dispute reviews programmatically:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;from&lt;/span&gt; &lt;span class="n"&gt;goofish_xianyu_api&lt;/span&gt; &lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="nc"&gt;GoofishClient&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;assess_seller_trust&lt;/span&gt;

&lt;span class="n"&gt;client&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;GoofishClient&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="c1"&gt;# Resolve a raw mobile share link first if you only have pasted text&lt;/span&gt;
&lt;span class="n"&gt;item&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get_item_detail&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"【闲鱼】https://m.tb.cn/h.5xyz123 点击链接直接打开"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="n"&gt;seller_id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;item&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"sellerId"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="ow"&gt;or&lt;/span&gt; &lt;span class="s2"&gt;"2214891234567"&lt;/span&gt;

&lt;span class="c1"&gt;# Fetch seller profile + compute objective 0-100 trust assessment&lt;/span&gt;
&lt;span class="n"&gt;profile&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get_seller_profile&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;seller_id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="n"&gt;trust&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;assess_seller_trust&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;profile&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"Seller Trust: {trust.trust_score}/100 | "&lt;/span&gt;
    &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"Zhima Tier: {trust.zhima_tier} | "&lt;/span&gt;
    &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"KYC Verified: {trust.is_kyc_verified} | "&lt;/span&gt;
    &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"Risk: {trust.risk_level}"&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"Signals:"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;trust&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;signals&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="c1"&gt;# Inspect historical sold comps to check if seller is a genuine hobbyist or grey-market dealer&lt;/span&gt;
&lt;span class="n"&gt;sold_history&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get_seller_items&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;seller_id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;status&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"sold"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;max_items&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;20&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"Sampled {len(sold_history)} historical sold items"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="c1"&gt;# Pull negative buyer feedback specifically to catch refurbishment / dispute red flags&lt;/span&gt;
&lt;span class="n"&gt;disputes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;client&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get_seller_reviews&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
    &lt;span class="n"&gt;seller_id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;review_filter&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"negative_only"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;max_reviews&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="mi"&gt;20&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;rev&lt;/span&gt; &lt;span class="k"&gt;in&lt;/span&gt; &lt;span class="n"&gt;disputes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"Dispute review:"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;rev&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"content"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  Step 4: Terminal CLI Exports (&lt;code&gt;json&lt;/code&gt;, &lt;code&gt;jsonl&lt;/code&gt;, &lt;code&gt;csv&lt;/code&gt;)
&lt;/h2&gt;

&lt;p&gt;Installing &lt;code&gt;goofish-xianyu-api&lt;/code&gt; also registers the &lt;code&gt;goofish-xianyu&lt;/code&gt; (and &lt;code&gt;goofish-scrape&lt;/code&gt;) CLI for one-liner CSV exports and cron scripts:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Multi-keyword translated watchlist -&amp;gt; JSONL (only newly listed items)&lt;/span&gt;
goofish-xianyu --format jsonl search \
  --keywords &lt;span class="s2"&gt;"Sony A7C2 mirrorless"&lt;/span&gt; &lt;span class="s2"&gt;"Pokemon card unopened"&lt;/span&gt; \
  --translate \
  --personal-only \
  --max-items 40 \
  --only-new ./seen_items.json

&lt;span class="c"&gt;# Export personal-seller deals with USD markdowns &amp;amp; Superbuy columns to CSV&lt;/span&gt;
goofish-xianyu --format csv --output camera_deals.csv search &lt;span class="s2"&gt;"理光 GR3x 箱说全"&lt;/span&gt; --personal-only --max-items 30
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  Step 5: Connect Claude Desktop, Cursor &amp;amp; Windsurf via MCP
&lt;/h2&gt;

&lt;p&gt;If you prefer researching secondhand comps conversationally inside &lt;strong&gt;Claude Desktop&lt;/strong&gt;, &lt;strong&gt;Cursor&lt;/strong&gt;, &lt;strong&gt;Windsurf&lt;/strong&gt;, or &lt;strong&gt;VS Code Copilot&lt;/strong&gt;, install the zero-dependency &lt;strong&gt;&lt;code&gt;goofish-xianyu-mcp&lt;/code&gt;&lt;/strong&gt; server in one command:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Install into Cursor (~/.cursor/mcp.json)&lt;/span&gt;
npx -y goofish-xianyu-mcp --install cursor --token apify_api_YOUR_TOKEN

&lt;span class="c"&gt;# Or install into Claude Desktop&lt;/span&gt;
npx -y goofish-xianyu-mcp --install claude --token apify_api_YOUR_TOKEN
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Or add it manually to &lt;code&gt;mcpServers&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;"mcpServers"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nl"&gt;"goofish-xianyu"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nl"&gt;"command"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"npx"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="nl"&gt;"args"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"-y"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"goofish-xianyu-mcp"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="nl"&gt;"env"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="nl"&gt;"APIFY_TOKEN"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"apify_api_YOUR_TOKEN"&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Once connected, your AI assistant gains 5 live tools (&lt;code&gt;search_goofish_items&lt;/code&gt;, &lt;code&gt;get_goofish_item_detail&lt;/code&gt;, &lt;code&gt;get_goofish_seller_profile&lt;/code&gt;, &lt;code&gt;get_goofish_seller_reviews&lt;/code&gt;, and &lt;code&gt;get_goofish_seller_items&lt;/code&gt;) — including multi-keyword &lt;code&gt;keywords&lt;/code&gt; deduplication, auto-pagination up to 100 listings, offline &lt;code&gt;translateKeywords&lt;/code&gt; slang conversion, and ready-to-click Superbuy/AllChinaBuy links.&lt;/p&gt;

&lt;p&gt;Try prompting Claude or Cursor:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;"Search Goofish personal sellers (&lt;code&gt;personalOnly=true&lt;/code&gt;, &lt;code&gt;translateKeywords=true&lt;/code&gt;) across &lt;code&gt;keywords: ['Sony A7C2 mirrorless', 'Fujifilm X100VI box and papers']&lt;/code&gt; up to 40 items between ¥7,500 and ¥12,000. Filter out local-pickup-only posts, audit the top 2 sellers' Zhima Credit and negative buyer reviews, and give me Superbuy links."&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;




&lt;h2&gt;
  
  
  Resources &amp;amp; Links
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Python SDK (&lt;code&gt;PyPI&lt;/code&gt;)&lt;/strong&gt;: &lt;a href="https://pypi.org/project/goofish-xianyu-api/" rel="noopener noreferrer"&gt;pypi.org/project/goofish-xianyu-api&lt;/a&gt; (&lt;code&gt;pip install goofish-xianyu-api&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;MCP Server (&lt;code&gt;npm&lt;/code&gt;)&lt;/strong&gt;: &lt;a href="https://www.npmjs.com/package/goofish-xianyu-mcp" rel="noopener noreferrer"&gt;npmjs.com/package/goofish-xianyu-mcp&lt;/a&gt; (&lt;code&gt;npx -y goofish-xianyu-mcp&lt;/code&gt;)&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Technical Documentation&lt;/strong&gt;: &lt;a href="https://unitbytes.com/actors/goofish-xianyu-search-scraper/" rel="noopener noreferrer"&gt;unitbytes.com/actors/goofish-xianyu-search-scraper&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;em&gt;Disclaimer: Independent integration powered by UnitBytes; not affiliated with or endorsed by Alibaba Group, 1688.com, or Goofish/Xianyu.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>python</category>
      <category>webscraping</category>
      <category>mcp</category>
      <category>productivity</category>
    </item>
  </channel>
</rss>
