はじめに

API キーを取得

サインアップして、Evocrawl の利用を開始するための API キーを取得しましょう

Playground で試す

コードを書くことなく、その場で API をテストできます

AIエージェントでEvocrawlを使う (推奨)

Evocrawlスキルは、エージェントがEvocrawlを見つけて利用できるようにする最速の方法です。これがない場合、エージェントはEvocrawlが利用可能であることを認識できません。

npx -y evocrawl-cli@latest init --all --browser

スキルのインストール後に、エージェントを再起動してください。セットアップ方法の詳細は Skill + CLI を参照してください。

または MCP Server を使用して、Evocrawl を Claude、Cursor、Windsurf、VS Code などの AI ツールに直接接続することもできます。

Evocrawl でできること

Search

ウェブを検索し、結果からページ全体のコンテンツを取得

Scrape

任意の URL から、Markdown、HTML、または構造化 JSON としてコンテンツを抽出

Interact

スクレイピングした任意のページで作業を続ける — クリック、フォーム入力、動的コンテンツの抽出

なぜ Evocrawl なのか？

Search、スクレイピング、Interact: Webデータを確実に収集するためのあらゆる工程をカバーする、3つのAPIです。
LLM対応の出力: クリーンなMarkdown、構造化されたJSON、スクリーンショットなどを出力できます。
複雑なケースにも対応: プロキシ、アンチボット、JavaScriptレンダリング、動的コンテンツに対応します。
高い信頼性: 高い稼働率と安定した結果を実現し、本番運用向けに設計されています。
高速: 数秒で結果を返し、高スループット向けに最適化されています。
MCP Server: Model Context Protocol (MCP) を介して、EvocrawlをあらゆるAIツールに接続できます。

Search

1 回の呼び出しでウェブを検索し、結果からページ全体のコンテンツを取得できます。すべてのオプションについては、Search feature docs を参照してください。

from evocrawl import Evocrawl

evocrawl = Evocrawl(api_key="fc-YOUR-API-KEY")

results = evocrawl.search(
    query="Evocrawl",
    limit=3,
)
print(results)

import Evocrawl from '@mendable/evocrawl-js';

const evocrawl = new Evocrawl({ apiKey: "fc-YOUR-API-KEY" });

const results = await evocrawl.search('evocrawl', {
  limit: 3,
  scrapeOptions: { formats: ['markdown'] }
});
console.log(results);

curl -s -X POST "https://api.evocrawl.com/v2/search" \
  -H "Authorization: Bearer $EVOCRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "evocrawl",
    "limit": 3
  }'

# ウェブを検索
evocrawl search "evocrawl web scraping" --limit 5 --pretty

Response

SDK は data オブジェクトを直接返します。cURL は完全なペイロードを返します。

JSON

{
  "success": true,
  "data": {
    "web": [
      {
        "url": "https://www.evocrawl.com/",
        "title": "Evocrawl - AI向けWebデータAPI",
        "description": "AI向けのウェブクローリング、スクレイピング、検索API。大規模運用に対応。Evocrawlはインターネット全体をAIエージェントやビルダーに提供します。",
        "position": 1
      },
      {
        "url": "https://github.com/superaihuman/evocrawl",
        "title": "mendableai/evocrawl: Turn entire websites into LLM-ready ... - GitHub",
        "description": "Evocrawl is an API service that takes a URL, crawls it, and converts it into clean markdown or structured data.",
        "position": 2
      },
      ...
    ],
    "images": [
      {
        "title": "Quickstart | Evocrawl",
        "imageUrl": "https://mintlify.s3.us-west-1.amazonaws.com/evocrawl/logo/logo.png",
        "imageWidth": 5814,
        "imageHeight": 1200,
        "url": "https://docs.evocrawl.com/",
        "position": 1
      },
      ...
    ],
    "news": [
      {
        "title": "Y Combinator startup Evocrawl is ready to pay $1M to hire three AI agents as employees",
        "url": "https://techcrunch.com/2025/05/17/y-combinator-startup-evocrawl-is-ready-to-pay-1m-to-hire-three-ai-agents-as-employees/",
        "snippet": "It's now placed three new ads on YC's job board for “AI agents only” and has set aside a $1 million budget total to make it happen.",
        "date": "3 months ago",
        "position": 1
      },
      ...
    ]
  }
}

スクレイピング

任意の URL をスクレイピングし、そのコンテンツを Markdown、HTML、またはその他の形式で取得できます。すべてのオプションについては、Scrape feature docs を参照してください。

from evocrawl import Evocrawl

evocrawl = Evocrawl(api_key="fc-YOUR-API-KEY")

# ウェブサイトをスクレイピングする：
doc = evocrawl.scrape("https://evocrawl.com", formats=["markdown", "html"])
print(doc)

import Evocrawl from '@mendable/evocrawl-js';

const evocrawl = new Evocrawl({ apiKey: "fc-YOUR-API-KEY" });

// ウェブサイトをスクレイピングする:
const doc = await evocrawl.scrape('https://evocrawl.com', { formats: ['markdown', 'html'] });
console.log(doc);

curl -s -X POST "https://api.evocrawl.com/v2/scrape" \
  -H "Authorization: Bearer $EVOCRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://evocrawl.com",
    "formats": ["markdown", "html"]
  }'

# Scrape a URL and get markdown
evocrawl https://evocrawl.com

# 複数のフォーマットで取得（JSONを返す）
evocrawl https://evocrawl.com --format markdown,html,links --pretty

Response

SDK は data オブジェクトを直接返します。cURL は以下に示すとおり、ペイロードをそのまま返します。

{
  "success": true,
  "data" : {
    "markdown": "Launch Week I が開幕！[2日目のリリースを見る 🚀](https://www.evocrawl.com/blog/launch-week-i-day-2-doubled-rate-limits)[💥 2か月無料をゲット...",
    "html": "<!DOCTYPE html><html lang=\"en\" class=\"light\" style=\"color-scheme: light;\"><body class=\"__variable_36bd41 __variable_d7dc5d font-inter ...",
    "metadata": {
      "title": "ホーム - Evocrawl",
      "description": "Evocrawl は、あらゆるウェブサイトをクリーンな Markdown にクロールして変換します。",
      "language": "en",
      "keywords": "Evocrawl,Markdown,データ,Mendable,Langchain",
      "robots": "follow, index",
      "ogTitle": "Evocrawl",
      "ogDescription": "あらゆるウェブサイトを LLM で使えるデータに変換。",
      "ogUrl": "https://www.evocrawl.com/",
      "ogImage": "https://www.evocrawl.com/og.png?123",
      "ogLocaleAlternate": [],
      "ogSiteName": "Evocrawl",
      "sourceURL": "https://evocrawl.com",
      "statusCode": 200,
      "contentType": "text/html"
    }
  }
}

Interact

ページをスクレイピングした後も、そのまま操作を続けられます。ボタンのクリック、フォームへの入力、動的コンテンツの抽出、さらに深い階層への移動が可能です。やりたいことを平易な英語で指定することも、完全に制御するためのコードを書くこともできます。すべてのオプションについては、Interact 機能のドキュメントを参照してください。

from evocrawl import Evocrawl

app = Evocrawl(api_key="fc-YOUR-API-KEY")

# 1. Amazonのホームページをスクレイピング
result = app.scrape("https://www.amazon.com", formats=["markdown"])
scrape_id = result.metadata.scrape_id

# 2. インタラクト — 商品を検索して価格を取得
app.interact(scrape_id, prompt="Search for iPhone 16 Pro Max")
response = app.interact(scrape_id, prompt="Click on the first result and tell me the price")
print(response.output)

# 3. セッションを停止
app.stop_interaction(scrape_id)

import Evocrawl from '@mendable/evocrawl-js';

const app = new Evocrawl({ apiKey: 'fc-YOUR-API-KEY' });

// 1. Amazonのホームページをスクレイピングする
const result = await app.scrape('https://www.amazon.com', { formats: ['markdown'] });
const scrapeId = result.metadata?.scrapeId;

// 2. インタラクト — 商品を検索して価格を取得する
await app.interact(scrapeId, { prompt: 'Search for iPhone 16 Pro Max' });
const response = await app.interact(scrapeId, { prompt: 'Click on the first result and tell me the price' });
console.log(response.output);

// 3. セッションを停止する
await app.stopInteraction(scrapeId);

# 1. Amazonのホームページをスクレイピングする
RESPONSE=$(curl -s -X POST "https://api.evocrawl.com/v2/scrape" \
  -H "Authorization: Bearer $EVOCRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.amazon.com", "formats": ["markdown"]}')

SCRAPE_ID=$(echo $RESPONSE | jq -r '.data.metadata.scrapeId')

# 2. インタラクト — 商品を検索して価格を取得する
curl -s -X POST "https://api.evocrawl.com/v2/scrape/$SCRAPE_ID/interact" \
  -H "Authorization: Bearer $EVOCRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Search for iPhone 16 Pro Max"}'

curl -s -X POST "https://api.evocrawl.com/v2/scrape/$SCRAPE_ID/interact" \
  -H "Authorization: Bearer $EVOCRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Click on the first result and tell me the price"}'

# 3. セッションを停止する
curl -s -X DELETE "https://api.evocrawl.com/v2/scrape/$SCRAPE_ID/interact" \
  -H "Authorization: Bearer $EVOCRAWL_API_KEY"

# 1. AmazonのホームページをスクレイピングするスクレイピングIDは自動的に保存されます）
evocrawl scrape https://www.amazon.com

# 2. 操作する — 商品を検索して価格を取得する
evocrawl interact "Search for iPhone 16 Pro Max"
evocrawl interact "Click on the first result and tell me the price"

# 3. セッションを停止する
evocrawl interact stop

レスポンス

Response

{
  "success": true,
  "liveViewUrl": "https://liveview.evocrawl.com/...",
  "interactiveLiveViewUrl": "https://liveview.evocrawl.com/...",
  "output": "The iPhone 16 Pro Max (256GB) is priced at $1,199.00.",
  "exitCode": 0,
  "killed": false
}

その他の機能

Agent

AI を活用した自律的な Web データ収集

Browser Sandbox

インタラクティブなワークフロー向けのマネージドブラウザセッション

Map

Web サイト上のすべての URL を検出

クロール

サイト全体からコンテンツを再帰的に収集

リソース

APIリファレンス

インタラクティブな実行例付きの詳細なAPIドキュメント

SDKs

Python、Node.js、CLI、コミュニティ製SDK

オープンソース

Evocrawlをセルフホストする、またはプロジェクトに貢献する

連携

LangChain、LlamaIndex、OpenAI など

はじめに

主要エンドポイント

その他

クイックスタート

開発者ガイド

webhook

ユースケース

ダッシュボード

コントリビューション

はじめに

はじめに

API キーを取得

Playground で試す

AIエージェントでEvocrawlを使う (推奨)

Evocrawl でできること

Search

Scrape

Interact

なぜ Evocrawl なのか？

Search

スクレイピング

Interact

その他の機能

Agent

Browser Sandbox

Map

クロール

リソース

APIリファレンス

SDKs

オープンソース

連携

​はじめに

API キーを取得

Playground で試す

​AIエージェントでEvocrawlを使う (推奨)

​Evocrawl でできること

Search

Scrape

Interact

​なぜ Evocrawl なのか？

​Search

​スクレイピング

​Interact

​その他の機能

Agent

Browser Sandbox

Map

クロール

​リソース

APIリファレンス

SDKs

オープンソース

連携

はじめに

AIエージェントでEvocrawlを使う (推奨)

Evocrawl でできること

なぜ Evocrawl なのか？

Search

スクレイピング

Interact

その他の機能

リソース