PTT 批踢踢爬蟲｜看板貼文、推噓文、輿情一鍵下載（免 API）

抓 PTT 批踢踢（ptt.cc）看板貼文列表與單篇全文+推文，結構化輸出，不需要帳號、不需要 API Key。支援 Gossiping、Stock 等 18+ 看板（自動帶 over18=1 cookie）。CheerioCrawler 純 HTML，不用 Playwright，成本極低。

---

輸出欄位

看板列表模式（board）

欄位	型別	說明	有值?
post_id	string|null	貼文 ID（如 M.1783087025.A.C75）	有值（少數舊格式為 null）
board	string	看板名稱（如 Stock）	一定有
title	string|null	標題（含分類標籤如 [心得]）	一定有（刪除文除外）
author	string|null	作者 ID	一定有
push_count	number|null	推噓淨值（推-噓；爆=100，XX=-100）	通常有（無推文時 null）
created_at	string|null	發文日期（格式 M/DD，如 7/03）	一定有
post_url	string	完整貼文網址	一定有
source_mode	string	"board"	一定有
source_query	string	看板名稱	一定有
scraped_at	string	抓取時間（ISO 8601）	一定有

單篇貼文模式（post）— 貼文詳情

欄位	型別	說明	有值?
post_id	string|null	貼文 ID	一定有
board	string|null	看板名稱	一定有
title	string|null	標題	一定有
author	string|null	作者 ID	一定有
content	string|null	正文（已去除頁首 meta 與頁尾發信站行）	一定有
category	string|null	標題分類（[分類] 括號內文字）	有分類標籤時才有值
push_count	number|null	推噓淨值（push_up − push_down）	通常有（無推文時 null）
push_up	number|null	推文數	一定有
push_down	number|null	噓文數	一定有
comment_count	number|null	推文總則數（推+噓+→）	一定有
ip	string|null	發信站 IP（從正文頁尾解析）	有發信站行時才有值
created_at	string|null	發文時間（PTT 格式，如 Fri Jul 3 21:57:03 2026）	一定有
post_url	string	完整貼文網址	一定有
source_mode	string	"post"	一定有
source_query	string	原始輸入 URL	一定有
scraped_at	string	抓取時間（ISO 8601）	一定有

單篇貼文模式（post）— 推文列表

每則推文輸出一個獨立 row：

欄位	型別	說明	有值?
comment_id	string	{post_id}_{floor}	一定有
post_id	string|null	所屬貼文 ID	一定有
board	string|null	看板名稱	一定有
floor	number	樓層（從 1 開始）	一定有
push_type	"推"|"噓"|"→"|null	推文類型	一定有
author	string|null	推文作者 ID	一定有
content	string|null	推文內容（已去除前綴 : ）	一定有
ip	null	PTT 推文不含完整 IP，固定為 null	一定 null
created_at	string|null	推文時間（格式 MM/DD HH:mm）	一定有
scraped_at	string	抓取時間（ISO 8601）	一定有

注意：ip 欄位在推文列表中固定為 null。PTT 推文只顯示月/日時間，不含 IP 資訊。

---

模式說明

mode	輸入欄位	輸出	計費事件
board	boards[] 看板名稱	看板最新貼文列表	search-listing 每筆 $0.002
post	postUrls[] 完整貼文網址	貼文全文 + 所有推文	product-detail 每篇 $0.008 + review-item 每則 $0.003

---

輸入設定

欄位	型別	說明	預設值
mode	"board" | "post"	模式選擇（省略時自動判斷）	自動
boards	string[]	看板名稱清單（board 模式）	—
postUrls	string[]	貼文完整網址（post 模式）	—
keywords	string[]	標題關鍵字過濾（選填，board 模式；含任一關鍵字即保留）	—
bulkInput	string	批量貼入：一行一個看板名稱或貼文網址，自動併入上面對應欄位	—
maxItems	integer	每個看板最多抓幾篇（board 模式）	50
proxyConfiguration	object	Proxy 設定（通常不需要，PTT 直連友善）	不使用

---

JSON 輸入範例

範例 1：抓 Stock 看板最新 20 篇

{
    "mode": "board",
    "boards": ["Stock"],
    "maxItems": 20
}

範例 2：同時抓多個看板 + 關鍵字過濾

{
    "mode": "board",
    "boards": ["Gossiping", "Stock", "Tech_Job"],
    "keywords": ["心得", "問卦"],
    "maxItems": 50
}

範例 3：抓 Gossiping（18+ 看板）

{
    "mode": "board",
    "boards": ["Gossiping"],
    "maxItems": 30
}

範例 4：抓單篇貼文全文 + 推文

{
    "mode": "post",
    "postUrls": [
        "https://www.ptt.cc/bbs/Stock/M.1783087025.A.C75.html"
    ]
}

範例 5：批量貼入看板名稱

{
    "mode": "board",
    "bulkInput": "Stock\nGossiping\nTech_Job\nHatePolitics",
    "maxItems": 30
}

---

注意事項

1. 18+ 看板（Gossiping、sex 等）自動帶 over18=1 cookie，無需額外設定。
2. 翻頁行為：board 模式從最新頁往舊頁翻，達到 maxItems 或連續 5 頁無新資料時停止。
3. 看板名稱大小寫：PTT 看板名稱區分大小寫，請以看板實際名稱輸入（如 Gossiping，非 gossiping）。
4. 刪除貼文：看板列表中已刪除的貼文不輸出（title 顯示為「本文已被刪除」的 row 跳過）。
5. push_count 特殊值：PTT 顯示「爆」表示 ≥100 推，本 actor 統一輸出為 100；「XX」= -100。
6. 推文 ip 欄位：固定為 null，PTT 推文介面僅顯示月/日時間，不含 IP。
7. 抓取速度：每個 domain 最多 5 並發，PTT 靜態頁速度快，一般不需 proxy。

---

FAQ

Q: 抓 Gossiping 需要帳號嗎？ 不需要，本 actor 自動帶 over18=1 cookie 跳過年齡同意頁面，完全免登入。

Q: 為什麼 push_count 顯示 100 而不是確切數字？ PTT 板面當推文淨值 ≥100 時顯示「爆」字而非實際數字，無法在看板列表精確取得。如需精確數字，請改用 post 模式抓取全文。

Q: board 模式可以抓多遠的舊文章？ 可無限往前翻頁，直到 maxItems 上限（最高 500）或連續 5 頁無新資料為止。

Q: post 模式的推文上限是多少？ PTT 沒有推文上限，本 actor 會抓完所有推文，一則一個 row（review-item 計費）。

Q: 可以抓隱板嗎？ 不行，本 actor 只抓公開看板，隱板需登入驗證，目前不支援。

---

免責聲明

本 actor 僅用於個人研究、學術分析、品牌監控等合法用途。使用時請遵守 PTT 服務條款（ptt.cc）及台灣相關法規。請勿大量爬取、勿商業轉售原始資料。作者不對任何因使用本工具造成的損害承擔責任。

---

PTT 爬蟲、批踢踢 爬蟲、PTT 推文、輿情監控、品牌聲量、台灣論壇數據