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
Email 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 主控台授權存取。 請遵循下列步驟:

  1. 在你的 Power Automate 流程中,加入任何 Apify 動作或觸發器。
  2. 當被要求建立連線時,請點擊 登入。
  3. 您將被導向至 Apify Console 授權頁面 console.apify.com。
  4. 如果你還沒登入 Apify,請輸入你的 Apify 帳號電子郵件和密碼(或使用 Google/GitHub 登入)。
  5. 檢視所需權限:
    • 個人資料 - 存取使用者個人資料
    • full_api_access - 代表您完全存取 Apify API
  6. 點擊 授權 以授予連接器存取權限。
  7. 你將被導向回 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 並取得結果

  1. 把 執行角色 動作加入你的流程中。
  2. 從你最近使用的演員或 Apify 商店中選擇一位演員。
  3. 提供演員所需的輸入 JSON。
  4. 新增「 取得資料集項目 」動作。
  5. 使用執行演員步驟的 預設資料集 ID 作為資料集參數。
  6. 在後續流程步驟中處理返還的項目。

事件驅動工作流程:對完成的執行進行反應

  1. 將 Actor 執行完成 的觸發器加為流程的觸發器。
  2. 選擇你想監控的演員。
  3. 選擇哪些完成狀態應該觸發流程(預設全部啟用)。
  4. 在後續步驟中,利用觸發有效載荷存取執行細節並檢索結果。

快速刮削工作流程

  1. 新增 「抓取單一網址 」動作。
  2. 輸入你想抓取的網址。
  3. 選擇爬蟲類型(大多數網站建議採用自適應型)。
  4. 使用 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 執行的完整資訊。