---
title: Apify
description: Apifyアクターを実行して結果を取得する
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="apify"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Apify](https://apify.com/)は、WebオートメーションとWebスクレイピングアクターを構築、デプロイ、大規模に実行するための強力なプラットフォームです。Apifyを使用すると、任意のWebサイトから有用なデータを抽出し、ワークフローを自動化し、データパイプラインをシームレスに接続できます。

Apifyでは以下のことが可能です：

- **既製または独自のアクターを実行する**：公開アクターを統合するか、独自のアクターを開発して、幅広いWebデータ抽出とブラウザタスクを自動化します。
- **データセットを取得する**：アクターによって収集された構造化データセットにリアルタイムでアクセスし管理します。
- **Webオートメーションをスケールする**：クラウドインフラストラクチャを活用して、堅牢なエラー処理を備えた同期または非同期のタスクを確実に実行します。

Simでは、Apify統合によりエージェントがプログラムでApifyの主要な操作を実行できます：

- **アクターの実行（同期）**：`apify_run_actor_sync`を使用してApifyアクターを起動し、完了を待って、実行が終了するとすぐに結果を取得します。
- **アクターの実行（非同期）**：`apify_run_actor_async`を使用してバックグラウンドでアクターを開始し、定期的に結果をポーリングします。これは長時間または複雑なジョブに適しています。

これらの操作により、エージェントはワークフロー内で直接、自動化、スクレイピング、データ収集またはブラウザ自動化タスクのオーケストレーションを行うことができます — すべて柔軟な構成と結果処理を備え、手動実行や外部ツールを必要としません。Apifyを動的な自動化およびデータ抽出エンジンとして統合し、プログラムでエージェントのWebスケールワークフローを強化します。
{/* MANUAL-CONTENT-END */}

## 使用方法

Apifyをワークフローに統合します。カスタム入力で任意のApifyアクターを実行し、結果を取得します。自動データセット取得機能を備えた同期および非同期実行の両方をサポートしています。

## ツール

### `apify_run_actor_sync`

APIPYアクターを同期的に実行して結果を取得（最大5分）

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | console.apify.com/account#/integrationsから取得したAPIFY APIトークン |
| `actorId` | string | はい | アクターIDまたはユーザー名/アクター名（例："janedoe/my-actor"またはアクターID） |
| `input` | string | いいえ | JSON文字列としてのアクター入力。必須フィールドについてはアクターのドキュメントを参照してください。 |
| `timeout` | number | いいえ | タイムアウト（秒）（デフォルト：アクターのデフォルト） |
| `build` | string | いいえ | 実行するアクタービルド（例："latest"、"beta"、またはビルドタグ/番号） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | アクターの実行が成功したかどうか |
| `runId` | string | APIFY実行ID |
| `status` | string | 実行ステータス（SUCCEEDED、FAILED、など） |
| `items` | array | データセット項目（完了した場合） |

### `apify_run_actor_async`

長時間実行タスク用のポーリングを使用して、APIPYアクターを非同期で実行

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | console.apify.com/account#/integrationsから取得したAPIFY APIトークン |
| `actorId` | string | はい | アクターIDまたはユーザー名/アクター名（例："janedoe/my-actor"またはアクターID） |
| `input` | string | いいえ | JSON文字列としてのアクター入力 |
| `waitForFinish` | number | いいえ | ポーリング開始前の初期待機時間（秒）（0-60） |
| `itemLimit` | number | いいえ | 取得する最大データセット項目数（1-250000、デフォルト100） |
| `timeout` | number | いいえ | タイムアウト（秒）（デフォルト：アクターのデフォルト） |
| `build` | string | いいえ | 実行するアクタービルド（例："latest"、"beta"、またはビルドタグ/番号） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | アクターの実行が成功したかどうか |
| `runId` | string | APIFY実行ID |
| `status` | string | 実行ステータス（SUCCEEDED、FAILED、など） |
| `datasetId` | string | 結果を含むデータセットID |
| `items` | array | データセット項目（完了した場合） |
