# PTT 批踢踢爬蟲｜看板貼文、推噓文、留言、輿情一鍵匯出（免 API） (`claude_code_reviewer/ptt-scraper`) Actor 免登入抓 PTT 批踢踢：看板貼文列表、單篇全文與所有推／噓／→ 推文（over18 自動處理），含樓層、作者、時間，輸出 JSON／CSV／Excel。網路輿情、社群口碑、鄉民風向必備。 - **URL**: https://apify.com/claude\_code\_reviewer/ptt-scraper.md - **Developed by:** [Chad](https://apify.com/claude_code_reviewer) (community) - **Categories:** News, Social media, AI - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 看板貼文 This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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 篇 ```json { "mode": "board", "boards": ["Stock"], "maxItems": 20 } ```` #### 範例 2：同時抓多個看板 + 關鍵字過濾 ```json { "mode": "board", "boards": ["Gossiping", "Stock", "Tech_Job"], "keywords": ["心得", "問卦"], "maxItems": 50 } ``` #### 範例 3：抓 Gossiping（18+ 看板） ```json { "mode": "board", "boards": ["Gossiping"], "maxItems": 30 } ``` #### 範例 4：抓單篇貼文全文 + 推文 ```json { "mode": "post", "postUrls": [ "https://www.ptt.cc/bbs/Stock/M.1783087025.A.C75.html" ] } ``` #### 範例 5：批量貼入看板名稱 ```json { "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 推文、輿情監控、品牌聲量、台灣論壇數據 # Actor input Schema ## `mode` (type: `string`): 要抓什麼?選一個模式，填下面對應欄位就好。 ## `boards` (type: `array`): 看板模式的看板名稱，例如：Gossiping、Stock、Tech\_Job。注意大小寫（PTT 區分大小寫）。 ## `keywords` (type: `array`): （選填）只保留標題包含任一關鍵字的貼文。例如：心得、新聞。留空表示不過濾。 ## `postUrls` (type: `array`): 單篇模式的完整貼文網址，例如：https://www.ptt.cc/bbs/Stock/M.1783087025.A.C75.html ## `bulkInput` (type: `string`): **一行一個**，按 Enter 換行。看板模式貼看板名稱，貼文模式貼貼文網址，執行時自動併入上面對應欄位。 ## `maxItems` (type: `integer`): 看板模式每個看板最多抓幾篇貼文。越多費用越高。 ## `proxyConfiguration` (type: `object`): PTT 對直連友善，通常不需要 proxy。遇到封鎖才開。 ## Actor input object example ```json { "mode": "board", "boards": [ "Stock" ], "maxItems": 50, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `dataset` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "board", "boards": [ "Stock" ] }; // Run the Actor and wait for it to finish const run = await client.actor("claude_code_reviewer/ptt-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "board", "boards": ["Stock"], } # Run the Actor and wait for it to finish run = client.actor("claude_code_reviewer/ptt-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "board", "boards": [ "Stock" ] }' | apify call claude_code_reviewer/ptt-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=claude_code_reviewer/ptt-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "PTT 批踢踢爬蟲｜看板貼文、推噓文、留言、輿情一鍵匯出（免 API）", "description": "免登入抓 PTT 批踢踢：看板貼文列表、單篇全文與所有推／噓／→ 推文（over18 自動處理），含樓層、作者、時間，輸出 JSON／CSV／Excel。網路輿情、社群口碑、鄉民風向必備。", "version": "1.0", "x-build-id": "rJKjFcbncibSHmvLF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/claude_code_reviewer~ptt-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-claude_code_reviewer-ptt-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/claude_code_reviewer~ptt-scraper/runs": { "post": { "operationId": "runs-sync-claude_code_reviewer-ptt-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/claude_code_reviewer~ptt-scraper/run-sync": { "post": { "operationId": "run-sync-claude_code_reviewer-ptt-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "🎯 模式", "enum": [ "board", "post" ], "type": "string", "description": "要抓什麼?選一個模式，填下面對應欄位就好。", "default": "board" }, "boards": { "title": "📋 看板名稱", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "看板模式的看板名稱，例如：Gossiping、Stock、Tech_Job。注意大小寫（PTT 區分大小寫）。", "items": { "type": "string" } }, "keywords": { "title": "🔍 標題關鍵字過濾", "maxItems": 20, "uniqueItems": true, "type": "array", "description": "（選填）只保留標題包含任一關鍵字的貼文。例如：心得、新聞。留空表示不過濾。", "items": { "type": "string" } }, "postUrls": { "title": "📄 貼文網址", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "單篇模式的完整貼文網址，例如：https://www.ptt.cc/bbs/Stock/M.1783087025.A.C75.html", "items": { "type": "string" } }, "bulkInput": { "title": "📋 批量貼上", "type": "string", "description": "**一行一個**，按 Enter 換行。看板模式貼看板名稱，貼文模式貼貼文網址，執行時自動併入上面對應欄位。" }, "maxItems": { "title": "📊 最多抓幾筆", "minimum": 1, "maximum": 500, "type": "integer", "description": "看板模式每個看板最多抓幾篇貼文。越多費用越高。", "default": 50 }, "proxyConfiguration": { "title": "🌐 Proxy（進階，通常不用開）", "type": "object", "description": "PTT 對直連友善，通常不需要 proxy。遇到封鎖才開。", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```