8591 寶物交易爬蟲｜遊戲幣、寶物、帳號、代練刊登價格一鍵下載（免 API、免登入）

一個 Actor 抓 8591（台灣最大遊戲虛擬商品交易平台之一）的遊戲商品刊登搜尋列表：遊戲幣、寶物、帳號、代練等刊登價格、賣家瀏覽數/成交數、伺服器、分類等完整欄位。不需要登入、不需要 8591 帳號，也不會存取任何需要驗證才看得到的內容——只抓公開商品 listing metadata（標題／價格／賣家 id／伺服器／瀏覽數），不碰帳號私密資料、不碰交易流程、不抓會員個資。走 8591 公開 JSON 端點，不開瀏覽器，速度快、成本低。

給誰用的：追蹤特定遊戲虛擬經濟行情波動的、做遊戲交易比價網站的、分析熱門賣家/商品的、跑遊戲市場數據分析的、論文需要資料集的、自己寫 side project 的工程師。

---

能抓到什麼

每一筆商品刊登都會拿到下面這些欄位（缺值一律回 null，不會少欄位）：

欄位	說明	範例
item_id	8591 商品 ID	2416505230
title	商品標題	🔥高品質24H全區天堂代打🔥包時180🔥破萬代打評價🔥各職業專精最高54
price_raw	原始價格字串	10,000
price	正規化後價格（新台幣元）	10000
quantity	數量／庫存	68
seller_id	賣家 ID	3706706
delivery_time	交貨方式描述（賣家出貨速度，非遊戲伺服器）	24h交貨
page_view	累積瀏覽數	4060
sell_count	累積成交數	931
is_top	是否為置頂/推廣刊登	true
posted_ago	相對上架時間（原始字串）	5個月前
game_id	遊戲 ID	68065
game_name	遊戲名稱	天堂：經典版
server_name	遊戲伺服器名稱	太陽神阿波羅
category	分類（幣/寶物/帳號/代練）	代練
image	商品圖（優先封面圖，缺則取第一張商品圖）	https://uploadcdn.8591.com.tw/ware/.../xxx.jpg
item_url	商品詳情頁網址	https://www.8591.com.tw/v3/mall/goods/2416505230
source_mode	這筆從哪個模式來的	search
source_query	抓取時用的遊戲輸入（名稱或 ID 原文）	天堂：經典版
scraped_at	抓取當下時間（ISO 8601）	2026-07-04T05:23:28.617Z

---

模式

mode	幹嘛用的	計費事件	單價
🔎 search	依遊戲抓商品刊登搜尋列表（幣/寶物/帳號/代練混合）	search-listing（每筆）	$0.002

v1.0 只有 search 一種模式。每次 Run 啟動都會額外收一次性的 actor-start 費用 $0.005。所有計費都在資料成功寫入 dataset 之後才會收，Run 結束時 log 會印出 total_items / charged / skipped 讓你對帳。

商品詳情頁（完整規格、賣家評價、篩選條件）規劃於 v1.1：v1.0 僅支援商品刊登列表搜尋。

---

輸入欄位

欄位	型別	必填	預設	說明
mode	enum	選填	search	v1.0 只有 search。
games	string[]	必填	—	遊戲名稱（例如 天堂：經典版、新楓之谷）或遊戲 ID（例如 68065）。至少填一個。單次最多 50 個。
bulkInput	string	選填	—	一行一個遊戲名稱或遊戲 ID，按 Enter 換行，不要加引號或逗號。執行時自動併入 games。
maxItems	integer	選填	50	每個遊戲最多抓幾筆商品刊登，1-500。越多費用越高。
proxyConfiguration	object	選填	關閉	8591 商品列表 API 對 datacenter 請求友善，預設不用 proxy 即可運作。

關於遊戲名稱→ID 對照：填遊戲名稱時，Actor 會自動打 8591 遊戲目錄端點（v5/game/list/{cat}，依序嘗試線上遊戲/手遊/網頁遊戲/Steam/3C 分類）找出對應的遊戲 ID；找不到會在 log 印出警告並跳過該筆輸入（不會讓整個 Run 失敗）。如果你已經知道遊戲 ID，直接填數字字串（例如 "68065"）可以完全略過對照，最快也最準。

---

範例

🔎 用遊戲名稱搜尋

{
    "mode": "search",
    "games": ["天堂：經典版"],
    "maxItems": 50
}

🔎 用遊戲 ID 搜尋（略過名稱對照，最快）

{
    "mode": "search",
    "games": ["68065"],
    "maxItems": 50
}

📋 批量貼上多款遊戲

{
    "mode": "search",
    "bulkInput": "天堂：經典版\n新楓之谷\n68065",
    "maxItems": 20
}

---

幾個要注意的地方

• 只抓公開商品 listing metadata（標題／價格／賣家 id／伺服器／瀏覽數）。不抓帳號私密資料、不碰交易流程、不抓會員個資——這些是公開的商業刊登資訊，與 8591 站方「禁止外借帳號」等使用者條款（規範買賣雙方交易行為）無關。
• 不用登入 / 不用 API token。填好 input 就能跑，沒有任何金鑰要設定。
• 對 8591 伺服器友善。每個 domain 併發數 ≤5，遇到失敗會用指數退避重試最多 3 次，連續 5 頁拿不到新資料就會自己停並在 log 寫原因，不會空轉燒錢。
• is_top 是「置頂/推廣排序」，不是單純布林開關：8591 原始 top_status 欄位其實是排序用的推廣名次（如 1、2、3...），一般（非推廣）刊登則固定回傳 9999999。本 Actor 把「名次 < 9999999」正規化成 is_top: true，方便你直接篩選。
• price/quantity/page_view/sell_count 正規化只信任已驗證過的格式：價格字串會先去除千分位逗號（如 10,000 → 10000）再轉數字；遇到無法辨識的格式會保留 price_raw 原始字串、price 給 null，不會亂猜數字。
• image 優先用封面圖，缺封面圖時退回第一張商品圖：8591 原始資料中 ware_cover_image 常為空字串，這時候會改用 ware_images[0]；兩者都沒有才會是 null。
• 遊戲名稱找不到時不會讓整個 Run 失敗：Actor 會在 log 印出警告並跳過該筆輸入，繼續處理其他遊戲；若所有遊戲都對照不到才會結束 Run（不收 search-listing 費用）。
• 商品詳情（完整規格、賣家評價、篩選條件）規劃於 v1.1，v1.0 尚未支援。

---

常見問題

Q: 填遊戲名稱一定要打全形冒號、標點都要一模一樣嗎？ 目前是精確比對（去除頭尾空白後完全相同的名稱才會對照成功），建議直接照 8591 官網顯示的遊戲名稱複製貼上；如果不確定，直接填遊戲 ID（數字字串）最保險。

Q: 遊戲 ID 要去哪裡查？ 可以先用遊戲名稱跑一次，Actor 會自動對照並在輸出的 game_id 欄位告訴你這款遊戲的 ID，之後就能直接用 ID 重跑更快。

Q: 費用怎麼算？ 每次 Run 啟動收一次 actor-start（$0.005）；search 模式每筆商品刊登收 search-listing（$0.002）。都是資料成功寫入 dataset 後才收費，Run log 會印出實際收費筆數。

Q: 抓不到資料怎麼辦？ 先確認遊戲名稱有沒有打錯字，或改用遊戲 ID 直接跑。爬蟲連續 5 次拿不到新資料就會自己停並在 log 寫原因，不會空轉燒錢。

Q: price 有時候是 null？ 只有遇到無法辨識的原始格式（非純數字或千分位逗號數字）才會是 null，這時候 price_raw 仍會保留原始字串，方便你自行判讀。

---

部署

apify login              # 首次:貼上 Apify token(不會寫進 repo)
apify push               # 建置並上傳到 Apify Store

上架後在 Apify Console 的 Monetization 設定 PPE 事件單價: actor-start $0.005、search-listing $0.002。

---

免責聲明

本爬蟲只收集 8591 遊戲虛擬商品交易平台公開可見的商品刊登列表資料，資料僅供研究與個人用途使用，不用於任何未經授權的商業轉售。使用前請自行確認符合 8591 服務條款與當地法規。對於資料的正確性、即時性或完整性，本 Actor 不做任何保證，商品實際庫存、價格與是否仍在售請以 8591 官網當下顯示為準。

---

8591 爬蟲、寶物交易、遊戲幣、遊戲帳號、代練、虛擬寶物、遊戲交易數據