# YouTube Email 擷取器 (`futurizerush/youtube-email-scraper-zh-tw`) Actor

從公開 YouTube 頻道頁面與公開連結網站整理商務電子郵件、網站、社群連結與頻道統計。支援頻道網址與關鍵字搜尋，結果可從 Apify Dataset 匯出 JSON 或 CSV。此 Actor 不登入帳號、不繞過驗證，也不存取非公開聯絡資訊。

- **URL**: https://apify.com/futurizerush/youtube-email-scraper-zh-tw.md
- **Developed by:** [Rush](https://apify.com/futurizerush) (community)
- **Categories:** Lead generation, Social media, Videos
- **Security:** Limited permissions
- **Stats:** 43 total users, 2 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $25.00 / 1,000 results

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## YouTube Email 擷取器（個人資料、網站、社群、電子郵件）

從公開 YouTube 頻道頁面與頻道連結的網站，整理電子郵件、網站、社群連結與頻道統計，協助建立合作名單及進行市場研究。

### 功能與可取得的資料

- 頻道簡介與公開「關於」資訊中的電子郵件。
- 創作者連結網站公開顯示的電子郵件（每個頻道最多檢查 3 個網站）。
- 頻道名稱、公開識別碼、簡介、訂閱者數量、觀看次數、影片數量、加入日期與地區。
- 頻道公開連結的網站與社群帳號。

本工具不會登入 YouTube，也不會取得「查看電子郵件地址」按鈕後方、私人頁面或需要人工驗證的聯絡資料。能否找到電子郵件，取決於創作者公開了哪些資訊。

### 快速開始

每次執行選擇一種模式；若要同時處理網址與關鍵字，請分開執行。

#### 頻道網址輸入範例

```json
{
  "輸入模式": "directUrls",
  "頻道網址清單": [
    "https://www.youtube.com/@nateherk",
    "https://www.youtube.com/@LiamOttley"
  ]
}
```

#### 關鍵字輸入範例

```json
{
  "輸入模式": "keywordSearch",
  "搜尋關鍵字清單": ["AI automation", "科技評測"],
  "每個關鍵字最大頻道數": 10,
  "最大結果數": 20,
  "地區設定": "TW"
}
```

先用少量頻道或具體的關鍵字確認結果，再調整數量。搜尋結果與可用資料會隨 YouTube 變動，設定的數量是上限，不保證一定取得相同筆數。

### 輸入欄位

| 欄位 | 說明 | 預設值 |
|---|---|---|
| `輸入模式` | `directUrls` 為頻道網址；`keywordSearch` 為關鍵字搜尋 | `directUrls` |
| `頻道網址清單` | 最多 100 個網址，支援頻道 handle、頻道 ID 與分頁網址；也可省略 https://（如 `youtube.com/@name`）或只寫 `@name`。無法辨識的連結會略過，並在紀錄與執行摘要中標示（若沒有任何可用連結，執行會直接停止，並在紀錄中逐一列出） | — |
| `搜尋關鍵字清單` | 最多 20 個關鍵字，每個最多 100 字元；達到最大結果數後不再搜尋其餘關鍵字，並列於執行摘要 | — |
| `每個關鍵字最大頻道數` | 每個關鍵字的頻道上限，1–200。YouTube 列出的頻道較少時，找到的也會較少 | 50 |
| `最大結果數` | 本次處理頻道的總上限，1–500。超過上限的頻道連結會略過，並在執行摘要中標示 | 100 |
| `地區設定` | 關鍵字搜尋的地區排序偏好 | `TW` |

地區設定可選台灣、美國、日本等輸入表單列出的地區。它影響搜尋排序，**不是頻道所在地篩選條件**；其他地區的頻道仍可能出現，部分頻道也未公開所在地。

繁體中文版的 API 輸入使用上述中文欄位名稱；模式值與地區代碼維持英文。需要 Apify 帳號，不需要另外提供 YouTube 登入資訊或 API 金鑰。

### 輸出資料

每個成功取得的頻道會儲存一列資料。同一個頻道的不同網址不會重複產生結果。無法取得的頻道列於「執行摘要」，不會產生失敗結果列。

以下是資料格式範例，整理自公開資料；統計數字及聯絡資訊會變動，請以實際執行結果為準。來源內容，例如頻道簡介、日期與所在地，不會自動翻譯。

```json
{
  "頻道名稱": "Marques Brownlee",
  "頻道ID": "UCBJycsmduvYEL83R_U4JriQ",
  "頻道網址": "https://www.youtube.com/@mkbhd",
  "訂閱者數量": "21.30M",
  "觀看次數": 5724655497,
  "影片數量": 1855,
  "加入日期": "Mar 21, 2008",
  "位置": "United States",
  "頻道描述": "MKBHD: Quality Tech Videos | YouTuber | Geek | Consumer Electronics | Tech Head | Internet Personality!\n\nbusiness@MKBHD.com\n\nNYC",
  "電子郵件清單": ["business@mkbhd.com"],
  "電子郵件數量": 1,
  "有電子郵件": true,
  "網站清單": [],
  "社群媒體": {
    "twitter": "http://twitter.com/MKBHD",
    "instagram": "http://instagram.com/MKBHD",
    "youtube": "http://youtube.com/c/TheStudio",
    "reddit": "http://reddit.com/r/MKBHD",
    "discord": "http://discord.gg/MKBHD"
  },
  "聯絡資訊": {
    "電子郵件清單": ["business@mkbhd.com"],
    "網站清單": [],
    "社群媒體": {
      "twitter": "http://twitter.com/MKBHD",
      "instagram": "http://instagram.com/MKBHD",
      "youtube": "http://youtube.com/c/TheStudio",
      "reddit": "http://reddit.com/r/MKBHD",
      "discord": "http://discord.gg/MKBHD"
    }
  },
  "描述網址": [],
  "搜尋關鍵字": "MKBHD",
  "處理成功": true,
  "資料不完整": false,
  "擷取時間": "2026-10-01T21:35:38.971Z"
}
```

| 欄位 | 類型 | 說明 |
|---|---|---|
| `頻道ID`、`頻道名稱`、`頻道網址` | 字串 | 公開頻道識別碼、名稱與網址 |
| `頻道描述` | 字串 | 公開簡介；未取得時為空字串 |
| `訂閱者數量` | 字串 | 顯示為 `772.0K`、`21.30M` 等格式；未取得時為 `未知` |
| `觀看次數`、`影片數量` | 整數或 null | 公開數量；未取得時保留 null，不以零代替 |
| `加入日期`、`位置` | 字串或 null | 頻道公開的加入日期與所在地 |
| `電子郵件清單` | 陣列 | 公開顯示的電子郵件；未驗證所有權或可投遞性 |
| `電子郵件數量`、`有電子郵件` | 整數、布林值 | 地址數量，以及是否找到地址 |
| `網站清單`、`描述網址` | 陣列 | 頻道連結的網站，以及簡介中的完整網址 |
| `社群媒體` | 物件 | 以社群平台名稱分類的公開連結 |
| `聯絡資訊` | 物件 | 彙整電子郵件、網站與社群連結，與對應的最外層欄位一致 |
| `搜尋關鍵字` | 字串或 null | 發現頻道時使用的關鍵字；網址模式為 null |
| `處理成功` | 布林值 | 已儲存的結果一律為 true；無法取得的頻道改列於執行摘要 |
| `資料不完整` | 布林值 | 連結網站上開啟的頁面無法讀取，或頻道連結的網站超過每個頻道檢查的 3 個時為 true。每個網站最多開啟 3 個頁面：頻道為它列出的連結中第一個能開啟的，接著依序是網站自己的聯絡頁面、/contact 頁面與關於頁面。頁面不存在（失效連結）不算在內。社群個人頁、常見短網址、連結整理頁與平台頁面（社群、商店、電子報、預約、音樂與影音服務）不會開啟查找電子郵件，也不會讓資料標示為不完整；已取得資訊仍保留 |
| `擷取時間` | 字串 | ISO 格式的資料取得時間 |

舊有資料可能包含選用的 `錯誤訊息` 欄位。目前無法取得的頻道統一列於執行摘要。

#### 查看與匯出結果

Output 頁面提供「概覽」、「聯絡資訊」與「頻道個人檔案」三種檢視，也能匯出 JSON 或 CSV。聯絡資訊檢視只選擇相關欄位，不會自動排除沒有電子郵件的頻道；需要純聯絡名單時，可依 `有電子郵件: true` 篩選。

開啟「執行摘要」查看儲存筆數、無法取得的頻道與原因、略過的連結、未搜尋的關鍵字、搜尋在結果列表結束前就停止的關鍵字（`keywordsCutShort`）、未處理的頻道（`pendingChannelUrls`）及提前結束原因。執行順利結束時，狀態訊息也會用同一句話摘要本次執行。沒有公開電子郵件的頻道，仍可有完整的頻道資料。摘要中的 `isPartial` 表示本次執行未完整完成；每列的 `資料不完整` 則表示該頻道的聯絡資訊檢查未完整完成。

API 可讀取 `OUTPUT` 執行摘要與 `FINAL_REPORT` 最終報告；這些報告保留英文欄位名稱，方便既有流程使用。`FINAL_REPORT.successRate` 為成功取得的頻道占成功與失敗頻道總數的百分比；重複網址及尚未處理的頻道不列入分母。

### 常見問題

**每個頻道都會有電子郵件嗎？**

不會。創作者可能未公開地址，或將地址放在需要登入的按鈕後方。沒有電子郵件不代表頻道資料擷取失敗。

**電子郵件有驗證過嗎？**

僅做格式與明顯雜訊檢查：佔位用地址、不回覆地址、監測服務地址，以及看起來像地址的圖片檔名都會排除；連結網站上的網站管理地址（例如 webmaster@）也會略過，但創作者寫在頻道說明裡的地址，即使以 admin@ 或 webmaster@ 開頭也會保留。工具不會寄送郵件，也不會驗證信箱所有權或可投遞性。連結網站上的地址可能是客服或服務窗口，請先確認用途是否符合你的需求。

**連結貼錯了會怎樣？**

不是 YouTube 頻道連結的項目（例如影片連結）會略過，並在紀錄與執行摘要中標示，其他頻道照常處理。若沒有任何一個是頻道連結，執行會直接停止，並在紀錄中逐一列出這些連結。YouTube 無法顯示的頻道（例如已被移除或終止的頻道）會列於執行摘要並附上原因。

**執行中途停止，資料會消失嗎？**

已儲存結果會保留在資料集中，執行摘要會標示未完成項目。若 YouTube 限制存取，或連續數個頻道頁面無法讀取，執行會提前停止，不再向 YouTube 要求它目前不提供的頁面，並在執行摘要列出未處理的頻道，方便你重新執行。你中止執行時若選擇讓它先收尾（gracefully），也一樣。若某筆資料是否儲存成功尚不明確，工具會保留進度供檢查，避免自動重複寫入。較舊的執行進度可能需要先由支援人員檢查，才能安全續跑。

**數量上限設得很高，就一定能取得那麼多頻道嗎？**

不一定。搜尋結果、公開資料可用性與執行限制都會影響取得數量。請先從少量結果確認適合你的用途，再調整輸入。

**能與 Google Sheets、Zapier 或 Make 搭配嗎？**

可以透過 Apify 的匯出、API 與整合功能，將結果接到你的既有工作流程。

### 教學與支援

觀看 [YouTube 頻道電子郵件擷取教學](https://youtube.com/shorts/KQaDH-9vAmo)。如有疑問，請使用 [Apify 平台](https://console.apify.com)的支援選項。

### 免責聲明

本工具在不登入任何帳號的情況下，讀取公開的 YouTube 頻道頁面與創作者連結的公開網站，只整理任何訪客都看得到的資訊，也不會點擊需要登入的「查看電子郵件地址」按鈕。使用者應遵守適用的資料保護、隱私與電子郵件規範，以及 [YouTube 服務條款](https://www.youtube.com/t/terms)。請用於合法合作與研究，避免未經同意的大量郵件。

歡迎瀏覽開發者提供的[其他工具](https://apify.com/futurizerush)。

***

關鍵字：YouTube 電子郵件擷取、頻道聯絡資訊、商務電子郵件、創作者合作、公開頻道資料、YouTube email scraper、OpenClaw、Claude Code、Gemini、Antigravity、Codex、ChatGPT。

# Actor input Schema

## `輸入模式` (type: `string`):

選擇一種模式：貼上你已有的頻道網址，或用關鍵字搜尋 YouTube 頻道後再整理資料。

## `頻道網址清單` (type: `array`):

選擇「我有頻道網址」時使用。每行貼上一個頻道連結，例如 https://www.youtube.com/@name（也可寫 youtube.com/@name 或 @name），支援 /videos 等分頁網址。無法辨識的連結會略過，並在紀錄與執行摘要中標示；若沒有任何可用連結，執行會停止並在紀錄中逐一列出。

## `搜尋關鍵字清單` (type: `array`):

選擇「用關鍵字搜尋頻道」時使用。每個關鍵字會各自搜尋一次，直到達到總頻道上限；越具體的利基詞通常越容易找到相關頻道。

## `每個關鍵字最大頻道數` (type: `integer`):

每個搜尋關鍵字最多收集多少個頻道；YouTube 列出的頻道較少時，收集到的也會較少。只會在關鍵字搜尋模式使用。

## `最大結果數` (type: `integer`):

本次執行最多處理的頻道數量。超過上限的頻道連結會略過，並在執行摘要中標示；關鍵字搜尋達到上限即停止。實際取得數量可能受公開資料可用性或執行限制影響。

## `地區設定` (type: `string`):

關鍵字搜尋的排序偏好，預設為台灣。這不是頻道所在地篩選條件，其他地區的頻道仍可能出現在結果中。

## Actor input object example

```json
{
  "輸入模式": "directUrls",
  "頻道網址清單": [
    "https://www.youtube.com/@mkbhd",
    "https://www.youtube.com/@LiamOttley",
    "https://www.youtube.com/@nateherk"
  ],
  "搜尋關鍵字清單": [
    "AI automation",
    "tech review"
  ],
  "每個關鍵字最大頻道數": 50,
  "最大結果數": 100,
  "地區設定": "TW"
}
```

# Actor output Schema

## `overview` (type: `string`):

所有擷取的頻道及其聯絡資訊

## `withEmails` (type: `string`):

查看頻道電子郵件、網站與社群連結；此檢視不會自動排除沒有電子郵件的頻道。

## `channelProfile` (type: `string`):

頻道的詳細個人資料與統計資料

## `allResults` (type: `string`):

所有擷取的資料（JSON 格式）

## `csvExport` (type: `string`):

將結果匯出為 CSV 檔案

## `runSummary` (type: `string`):

儲存筆數、無法取得的頻道與原因、略過的連結、未搜尋或搜尋提前停止的關鍵字，以及未處理的頻道。

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "輸入模式": "directUrls",
    "頻道網址清單": [
        "https://www.youtube.com/@mkbhd",
        "https://www.youtube.com/@LiamOttley",
        "https://www.youtube.com/@nateherk"
    ],
    "搜尋關鍵字清單": [
        "AI automation",
        "tech review"
    ],
    "每個關鍵字最大頻道數": 50,
    "最大結果數": 100,
    "地區設定": "TW"
};

// Run the Actor and wait for it to finish
const run = await client.actor("futurizerush/youtube-email-scraper-zh-tw").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "輸入模式": "directUrls",
    "頻道網址清單": [
        "https://www.youtube.com/@mkbhd",
        "https://www.youtube.com/@LiamOttley",
        "https://www.youtube.com/@nateherk",
    ],
    "搜尋關鍵字清單": [
        "AI automation",
        "tech review",
    ],
    "每個關鍵字最大頻道數": 50,
    "最大結果數": 100,
    "地區設定": "TW",
}

# Run the Actor and wait for it to finish
run = client.actor("futurizerush/youtube-email-scraper-zh-tw").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "輸入模式": "directUrls",
  "頻道網址清單": [
    "https://www.youtube.com/@mkbhd",
    "https://www.youtube.com/@LiamOttley",
    "https://www.youtube.com/@nateherk"
  ],
  "搜尋關鍵字清單": [
    "AI automation",
    "tech review"
  ],
  "每個關鍵字最大頻道數": 50,
  "最大結果數": 100,
  "地區設定": "TW"
}' |
apify call futurizerush/youtube-email-scraper-zh-tw --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,futurizerush/youtube-email-scraper-zh-tw"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/AbChNN7s6JL9mVqsf/builds/gjIlbMjgIlsodKMWM/openapi.json
