Apify(預覽版)
Apify 執行網頁爬蟲與 AI 代理,管理演員與任務,排程與監控執行,檢索資料集與結果,並觸發 webhook 的流程。 它促進了從端到端的資料收集、豐富化與工作流程自動化。
此連接器適用於以下產品和區域:
| Service | Class | 地區 |
|---|---|---|
| Copilot Studio | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 聯絡方式 | |
|---|---|
| 名字 | Apify 支援 |
| URL | https://apify.com/contact |
| support@apify.com |
| 連接器中繼資料 | |
|---|---|
| 發行者 | Apify |
| 想了解更多關於 Apify 的資訊。 | https://docs.apify.com |
| 網站 | https://apify.com |
| 隱私權原則 | https://apify.com/privacy-policy |
| 類別 | 資料;人工智慧 |
Apify
Apify 是最大的 AI 工具市場。 Power Automate 的 Apify 連接器讓你能執行網頁爬蟲和 AI 代理(稱為 Actors)、執行預先設定的任務、從資料集和鍵值儲存中擷取結構化資料,並在工作結束時觸發自動化工作流程。 Apify 商店上有超過 30,000 個現成的角色,適用於常見的爬蟲與自動化使用場景。
發行者
Apify Technologies s.r.o.
Prerequisites
- Apify 帳號 ——免費註冊於 apify.com。 包含免費方案及每月平台點數。
- OAuth 2.0 授權 ——連接器透過 Apify 的 OAuth 流程進行認證。 終端使用者不需要 API 憑證或手動設定憑證。
如何取得認證
該連接器採用 OAuth 2.0 認證。 當你將 Apify 連接器加入流程並建立新連線時,系統會自動導向 Apify 主控台授權存取。 請遵循下列步驟:
- 在你的 Power Automate 流程中,加入任何 Apify 動作或觸發器。
- 當被要求建立連線時,請點擊 登入。
- 您將被導向至 Apify Console 授權頁面
console.apify.com。 - 如果你還沒登入 Apify,請輸入你的 Apify 帳號電子郵件和密碼(或使用 Google/GitHub 登入)。
- 檢視所需權限:
- 個人資料 - 存取使用者個人資料
- full_api_access - 代表您完全存取 Apify API
- 點擊 授權 以授予連接器存取權限。
- 你將被導向回 Power Automate,連線仍活躍。
終端使用者無需手動輸入 API 權杖、客戶端 ID 或秘密資料。 連接器會自動處理令牌刷新。
給 Microsoft 認證審查團隊
要測試連接器,你需要一個 Apify 帳號。 你可以在 apify.com 免費建立一個,不需要信用卡。 免費方案包含足夠的平台點數,可用於執行測試演員並驗證所有連接器操作。 建立帳號後,依照上述步驟 1-7 授權連接器。
支援的作業
行動
| Operation | 描述 |
|---|---|
| 跑步演員 | 執行一個 Apify 演員,輸入指定。 你可以從最近使用的演員中選擇,或瀏覽 Apify 商店。 可選擇等待最多60秒讓跑步結束。 返回資料會執行包含狀態、資料集 ID 及鍵值儲存 ID 等元資料。 |
| 執行任務 | 執行預先設定好的 Actor 任務。 任務會儲存預設的輸入設定,這樣你就可以執行它們,而不必每次都指定輸入。 可選擇用自訂值覆蓋預設輸入。 |
| 擷取單一網址 | 使用 Apify 網頁爬蟲演員擷取單一網頁。 可選擇自適應模式(建議)、Firefox 無頭瀏覽器,或 Cheerio(原始 HTTP)爬行模式。 回傳跑中繼資料以供追蹤。 |
| 取得資料集項目 | 從 Apify 資料集中擷取項目。 資料集儲存演員執行的結構化結果。 支援帶有極限與偏移參數的分頁。 回應結構是從資料集內容動態推斷而成。 |
| 取得鍵值儲存記錄 | 從 Apify 鍵值儲存庫中,依照其鍵擷取記錄。 鍵值儲存則儲存檔案、設定與執行狀態。 回應結構是從記錄內容動態推斷而成。 |
Triggers
| Operation | 描述 |
|---|---|
| 演員連載結束 | 當選定的演員執行結束時會觸發。 訂閱特定完成狀態:成功、失敗、逾時或中止。 所有狀態預設都是啟用的。 觸發有效載荷包含完整的執行細節與元資料。 |
| 演員任務完成 | 當選定的演員任務執行結束時會觸發。 狀態過濾選項和 Actor 執行完成觸發一樣。 對於監控排程或重複執行的任務非常有用。 |
入門指南
基本工作流程:執行一個 Actor 並取得結果
- 把 執行角色 動作加入你的流程中。
- 從你最近使用的演員或 Apify 商店中選擇一位演員。
- 提供演員所需的輸入 JSON。
- 新增「 取得資料集項目 」動作。
- 使用執行演員步驟的 預設資料集 ID 作為資料集參數。
- 在後續流程步驟中處理返還的項目。
事件驅動工作流程:對完成的執行進行反應
- 將 Actor 執行完成 的觸發器加為流程的觸發器。
- 選擇你想監控的演員。
- 選擇哪些完成狀態應該觸發流程(預設全部啟用)。
- 在後續步驟中,利用觸發有效載荷存取執行細節並檢索結果。
快速刮削工作流程
- 新增 「抓取單一網址 」動作。
- 輸入你想抓取的網址。
- 選擇爬蟲類型(大多數網站建議採用自適應型)。
- 使用 Actor run 完成 觸發器或 poll for completion 來取得結果。
已知問題和限制
- 等待完賽參數最長為60秒。 對於長期運行的演員,請使用 演員執行完成 的觸發條件,而不是等待。
- 資料集結構是從樣本項目動態推斷而成。 如果資料集中項目結構多變,它們可能無法涵蓋所有可能的欄位。
- 鍵值儲存記錄結構是從記錄內容推斷而來。 二進位紀錄(圖片、PDF)則 as-is 回傳,無需模式推論。
- Scrape 單一 URL 動作使用固定的 Actor(網頁爬蟲)。 進階爬取情境,請使用 Run Actor 搭配 Apify Store 的專用 Actor。
- 記憶體配置選項範圍從 128 MB 到 32 GB 不等。 先從預設設定開始,以優化成本。
常見錯誤和補救措施
| 錯誤 | 補救方法 |
|---|---|
| 無法驗證 | 確保你有一個有效的 Apify 帳號。 試著移除連線並重新建立一個。 |
| 演員執行會回傳失敗狀態 | 請查看 Apify 控制台的 Actor 執行日誌,裡面有詳細的錯誤訊息。 確認輸入與演員預期格式相符。 |
| 執行完成後資料集為空 | 確認演員連載已以成功狀態結束。 目標網站的結構可能已經改變。 |
| Flow 在等待 Actor 時會超時 | 將「等待結束」設為 0,並使用「演員執行結束」觸發器來非同步處理長時間執行的演員。 |
| Webhook 觸發器無法觸發 | 確認 Actor 或任務 ID 是否正確。 檢查至少有一個活動狀態已啟用。 |
FAQ
Apify 的價格是多少? 連接器本身是免費的。 根據計算時間和資源消耗,Apify 對平台使用量收費。 每個帳號都包含免費方案和每月點數。 詳情請參見 apify.com/pricing 。
什麼是演員? Actor 是運行在 Apify 平台上的無伺服器雲端程式。 他們能執行網頁爬蟲、資料擷取、人工智慧自動化等多種功能。 瀏覽超過30,000名現成演員,盡 apify.com/store。
什麼是任務? 任務是為演員儲存的設定。 它們會儲存預設輸入值,讓你能用預設參數執行演員,而不必每次都重新輸入。
有用的鏈接
動作
| 取得資料集項目 |
從你的 Apify 資料集中取得項目,並可選地設定分頁參數。 |
| 取得鍵值儲存記錄 |
在特定鍵值下,會取得一個儲存在鍵值儲存中的值。 |
| 執行工作 |
執行一個演員任務後,立即返回,不等任務結束。 要等待執行結束,請使用 waitForFinish 查詢參數。 |
| 擷取單一網址 |
使用 Web Scraper Actor 抓取單一 URL。 此動作啟動非同步抓取並立即回傳執行細節。 抓取完成後,使用 Actor run 完成觸發器來處理結果。 |
| 跑步演員 |
跑完演員後立刻回來,不等跑完。 要等待執行結束,請使用 waitForFinish 查詢參數。 |
取得資料集項目
從你的 Apify 資料集中取得項目,並可選地設定分頁參數。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Dataset
|
datasetId | True | string |
選擇要從哪個資料集取出項目。 |
|
Limit
|
limit | integer |
最多可歸還物品數量。 |
|
|
Offset
|
offset | integer |
清單開頭可以跳過的項目數量。 |
傳回
取得鍵值儲存記錄
在特定鍵值下,會取得一個儲存在鍵值儲存中的值。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Microsoft Store
|
storeId | True | string |
選擇要從中取回記錄的鍵值儲存。 |
|
鑰匙
|
recordKey | True | string |
選擇要讀取紀錄的鍵。 |
傳回
執行工作
執行一個演員任務後,立即返回,不等任務結束。 要等待執行結束,請使用 waitForFinish 查詢參數。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Task
|
taskId | True | string |
執行任務識別碼。 |
|
等待結束(0-60秒)
|
waitForFinish | integer |
等跑完(0-60秒)。 |
|
|
超時 (秒)
|
timeout | integer |
跑動暫停,幾秒鐘內結束。 |
|
|
Build
|
build | string |
Actor 建置要執行(標籤或建置號)。 通常是「最新」的。 |
|
|
記憶體 (MB)
|
memory | integer |
記憶體限制以 MB 為單位(2 的冪次方,最小 128 小時)。 |
|
|
|
object |
一個原始的 JSON 物件,用來覆寫任務的預設輸入。 |
擷取單一網址
使用 Web Scraper Actor 抓取單一 URL。 此動作啟動非同步抓取並立即回傳執行細節。 抓取完成後,使用 Actor run 完成觸發器來處理結果。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
爬取網址
|
url | True | string |
要抓取的單一頁面完整網址。 必須是有效的網址格式。 |
|
履帶車型
|
crawler_type | True | string |
選擇爬取引擎來抓取頁面。 |
跑步演員
跑完演員後立刻回來,不等跑完。 要等待執行結束,請使用 waitForFinish 查詢參數。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
精選演員
|
actorScope | True | string |
請選擇來源搜尋演員。 |
|
Actor
|
actorId | True | string |
執行演員識別碼。 供應演員ID。 |
|
等待結束(0-60秒)
|
waitForFinish | integer |
等跑完(0-60秒)。 |
|
|
超時 (秒)
|
timeout | integer |
跑動暫停,幾秒鐘內結束。 |
|
|
Build
|
build | string |
Actor 建置要執行(標籤或建置號)。 通常是「最新」的。 |
|
|
記憶體 (MB)
|
memory | integer |
記憶體限制以 MB 為單位(2 的冪次方,最小 128 小時)。 |
|
|
|
object |
原始的 JSON 物件以 INPUT 傳遞給演員。 |
觸發程序
| 演員任務完成 |
建立一個 webhook 來訂閱 Actor 的任務執行事件。 當所選演員任務執行以特定狀態結束時觸發。 所有狀態預設皆為啟用;只有明確設為 false 的狀態才會被排除。 至少必須維持一個狀態為啟用狀態。 |
| 演員連載結束 |
建立一個 webhook 來訂閱 Actor 執行事件。 當所選的演員執行結束時會觸發特定狀態。 所有狀態預設皆為啟用;只有明確設為 false 的狀態才會被排除。 至少必須維持一個狀態為啟用狀態。 |
演員任務完成
建立一個 webhook 來訂閱 Actor 的任務執行事件。 當所選演員任務執行以特定狀態結束時觸發。 所有狀態預設皆為啟用;只有明確設為 false 的狀態才會被排除。 至少必須維持一個狀態為啟用狀態。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
狀態
|
eventTypes | array of string |
演員執行狀態來觸發。 |
|
|
Task
|
actorTaskId | True | string |
請選擇演員任務來監控事件。 |
|
觸發 On Run 成功
|
onRunSucceeded | boolean |
當演員成功執行時觸發。 如果未設定,則預設為 true。 |
|
|
啟動時 失敗
|
onRunFailed | boolean |
當 Actor 執行失敗時觸發。 如果未設定,則預設為 true。 |
|
|
觸發啟動 執行時間過時
|
onRunTimedOut | boolean |
當演員跑出超時時觸發。如果沒有設定,則預設為 true。 |
|
|
觸發點 運行 中止
|
onRunAborted | boolean |
當演員執行中止時觸發。 如果未設定,則預設為 true。 |
傳回
當 Actor 執行結束時,事件有效載荷由 webhook 傳送。
- Webhook 負載
- WebhookPayloadSchema
演員連載結束
建立一個 webhook 來訂閱 Actor 執行事件。 當所選的演員執行結束時會觸發特定狀態。 所有狀態預設皆為啟用;只有明確設為 false 的狀態才會被排除。 至少必須維持一個狀態為啟用狀態。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
精選演員
|
actorScope | True | string |
請選擇來源搜尋演員。 |
|
狀態
|
eventTypes | array of string |
演員執行狀態來觸發。 |
|
|
Actor
|
actorId | True | string |
監控演員識別碼。 供應演員ID。 |
|
觸發 On Run 成功
|
onRunSucceeded | boolean |
當演員成功執行時觸發。 如果未設定,則預設為 true。 |
|
|
啟動時 失敗
|
onRunFailed | boolean |
當 Actor 執行失敗時觸發。 如果未設定,則預設為 true。 |
|
|
觸發啟動 執行時間過時
|
onRunTimedOut | boolean |
當演員跑出超時時觸發。如果沒有設定,則預設為 true。 |
|
|
觸發點 運行 中止
|
onRunAborted | boolean |
當演員執行中止時觸發。 如果未設定,則預設為 true。 |
傳回
當 Actor 執行結束時,事件有效載荷由 webhook 傳送。
- Webhook 負載
- WebhookPayloadSchema
定義
ActorRunResponseSchema
關於執行中的 Actor 執行的完整資訊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
演員執行識別碼
|
id | string |
Actor 執行的唯一識別碼。 |
|
執行者ID
|
actId | string |
被執行的演員的唯一識別碼。 |
|
使用者識別碼
|
userId | string |
擁有 Actor 執行的使用者的唯一識別碼。 |
|
演員任務識別碼
|
actorTaskId | string |
演員任務的唯一識別碼(若執行是從任務開始)。 |
|
從
|
startedAt | date-time |
時間戳記是演員(Actor)開始的時間點。 |
|
最終於
|
finishedAt | date-time |
演員連載結束的時間戳記。 |
|
Status
|
status | string |
演員執行狀態(例如:成功、失敗、執行中、中止)。 |
|
狀態訊息
|
statusMessage | string |
演員執行時的詳細狀態訊息,包括處理摘要與結果。 |
|
是狀態訊息終端機
|
isStatusMessageTerminal | boolean |
狀態訊息是終端(最終)還是在執行過程中可能改變。 |
|
後設資料
|
meta | object |
關於 Actor 執行的額外元資料,包括來源與使用者代理資訊。 |
|
價格資訊
|
pricingInfo | object |
詳細的定價資訊,包括定價模式、活動及成本細分。 |
|
統計資料
|
stats | object |
效能統計資料包括執行時、記憶體使用率、CPU 使用率及網路流量。 |
|
計時事件計數
|
chargedEventCounts | object |
演員期間發生的計費事件數量。 |
|
選項
|
options | object |
用於 Actor 執行的設定選項(記憶體、逾時、建置版本等)。 |
|
組建標識碼
|
buildId | string |
本次執行所用演員建置的唯一識別碼。 |
|
退出代碼
|
exitCode | number |
Actor 程序回傳的退出碼(0 表示成功)。 |
|
預設鍵值儲存識別碼
|
defaultKeyValueStoreId | string |
與此執行關聯的預設鍵值儲存的唯一識別碼。 |
|
預設資料集識別碼
|
defaultDatasetId | string |
演員儲存結果的預設資料集的唯一識別碼。 |
|
預設請求佇列識別碼
|
defaultRequestQueueId | string |
演員所使用的預設請求佇列的唯一識別碼。 |
|
組建編號
|
buildNumber | string |
本次運行所使用的 Actor 版本的建置號。 |
|
容器網址
|
containerUrl | string |
執行 Actor 執行容器的網址。 |
|
容器伺服器準備好了嗎
|
isContainerServerReady | boolean |
容器伺服器是否準備好且可存取。 |
|
Git 分支名稱
|
gitBranchName | string |
本次 Actor 執行所使用的 Git 分支名稱(如適用)。 |
|
使用總額 USD
|
usageTotalUsd | number |
演員的總成本以美元計算。 |
WebhookPayloadSchema
當 Actor 執行結束時,事件有效載荷由 webhook 傳送。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
userId
|
userId | string |
擁有與事件相關資源的使用者識別碼。 |
|
createdAt
|
createdAt | date-time |
事件發生時的時間戳。 |
|
eventType
|
eventType | string |
觸發 webhook 的事件類型(例如 ACTOR.快跑。成功了)。 |
|
actorId
|
eventData.actorId | string |
觸發演員的識別碼。 |
|
演員跑動
|
eventData.actorRunId | string |
觸發事件的特定演員跑法的ID。 |
|
演員執行回應
|
resource | ActorRunResponseSchema |
關於執行中的 Actor 執行的完整資訊。 |