# はじめに (/ja/introduction)
**AIエージェント向け:** すべてのドキュメントの完全なインデックスについては、[llms.txt](/ja/llms.txt)を参照してください。
報奨：5,000クレジット
Firecrawlへの有益なフィードバックに進呈
対象となるには、Firecrawl Feedback Assistantとの内容の濃いインタビュー (よく考えられた具体的なユースケースなど) を完了してください。所要時間は数分で、いつでも中断できます。人間にもエージェントにも対応しており、エージェント用ハーネスにリンクを貼り付けるだけで利用できます。Firecrawlを初めて使う方のご意見も歓迎します。
インタビューを開始
報奨の対象となるには、メールアドレスを入力してください。インタビューは毎週末に品質を確認します。
## はじめに [#はじめに]
### Firecrawl CLIをインストールする [#firecrawl-cliをインストールする]
1 つのコマンドで、Firecrawl CLIをインストールし、ブラウザで認証して、検出されたすべてのコーディングエージェントにスキルを追加できます。
```bash
npx -y firecrawl-cli@latest init --all --browser
```
セットアップ後に、コーディングエージェントを再起動して、新しいスキルを認識できるようにしてください。セットアップ方法の詳細は
[Skills + CLI](/ja/sdks/cli) を参照してください。
### エージェントを使ってセットアップ [#エージェントを使ってセットアップ]
この Firecrawl のセットアップ用 prompt をエージェントに渡してください。
### 直接 Build してテスト [#直接-build-してテスト]
直接 API にアクセスし、より高い上限を利用するには、無料の account を作成してください
コードを書かずに、browser で Firecrawl をテストできます
***
## Firecrawl でできること [#firecrawl-でできること]
ウェブを検索し、結果からページ全体のコンテンツを取得
任意の URL から、Markdown、HTML、または構造化 JSON としてコンテンツを抽出
スクレイピングした任意のページで作業を続ける: クリック、フォーム入力、動的コンテンツの抽出
### なぜ Firecrawl なのか？ [#なぜ-firecrawl-なのか]
* **LLM対応の出力**: クリーンなMarkdown、構造化されたJSON、スクリーンショットなどを出力できます。
* **複雑なケースにも対応**: プロキシ、アンチボット、JavaScriptレンダリング、動的コンテンツに対応します。
* **高い信頼性**: 高い稼働率と安定した結果を実現し、本番運用向けに設計されています。
* **高速**: 数秒で結果を返し、高スループット向けに最適化されています。
* **MCP Server**: [Model Context Protocol (MCP) ](/ja/mcp-server) を介して、FirecrawlをあらゆるAIツールに接続できます。
***
## Search [#search]
1 回の呼び出しでウェブを検索し、結果からページ全体のコンテンツを取得できます。すべてのオプションについては、[Search feature docs](/ja/features/search) を参照してください。
Python
Node
cURL
CLI
```python
from firecrawl import Firecrawl
firecrawl = Firecrawl(
# 開始にAPIキーは不要です。より高いrate limitsを得るには追加してください：
# api_key="fc-YOUR-API-KEY",
)
results = firecrawl.search(
query="firecrawl",
limit=3,
)
print(results)
```
```js
import { Firecrawl } from 'firecrawl';
const firecrawl = new Firecrawl({
// 開始にAPIキーは不要です — レート制限を引き上げるには追加してください:
// apiKey: "fc-YOUR-API-KEY",
});
const results = await firecrawl.search('firecrawl', {
limit: 3,
scrapeOptions: { formats: ['markdown'] }
});
console.log(results);
```
```bash
# 開始するためにAPI keyは不要です — より高いrate limitsを利用するには -H "Authorization: Bearer $FIRECRAWL_API_KEY" を追加してください:
curl -s -X POST "https://api.firecrawl.dev/v2/search" \
-H "Content-Type: application/json" \
-d '{
"query": "firecrawl",
"limit": 3
}'
```
```bash
# ウェブを検索
firecrawl search "firecrawl web scraping" --limit 5 --pretty
```
SDK は data オブジェクトを直接返します。cURL は完全なペイロードを返します。
```json title="JSON"
{
"success": true,
"data": {
"web": [
{
"url": "https://www.firecrawl.dev/",
"title": "Firecrawl - AI向けWebデータAPI",
"description": "AI向けのウェブクローリング、スクレイピング、検索API。大規模運用に対応。Firecrawlはインターネット全体をAIエージェントやビルダーに提供します。",
"position": 1
},
{
"url": "https://github.com/firecrawl/firecrawl",
"title": "mendableai/firecrawl: Turn entire websites into LLM-ready ... - GitHub",
"description": "Firecrawl is an API service that takes a URL, crawls it, and converts it into clean markdown or structured data.",
"position": 2
},
...
],
"images": [
{
"title": "Quickstart | Firecrawl",
"imageUrl": "https://mintlify.s3.us-west-1.amazonaws.com/firecrawl/logo/logo.png",
"imageWidth": 5814,
"imageHeight": 1200,
"url": "https://docs.firecrawl.dev/",
"position": 1
},
...
],
"news": [
{
"title": "Y Combinator startup Firecrawl is ready to pay $1M to hire three AI agents as employees",
"url": "https://techcrunch.com/2025/05/17/y-combinator-startup-firecrawl-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](/ja/features/scrape) を参照してください。
Python
Node
cURL
CLI
```python
from firecrawl import Firecrawl
firecrawl = Firecrawl(
# 開始するのにAPI キーは不要です。より高いレート制限のために追加してください：
# api_key="fc-YOUR-API-KEY",
)
# ウェブサイトをスクレイピングする：
doc = firecrawl.scrape("https://firecrawl.dev", formats=["markdown", "html"])
print(doc)
```
```js
import { Firecrawl } from 'firecrawl';
const firecrawl = new Firecrawl({
// 開始するのにAPIキーは不要です — より高いレート制限のために追加してください:
// apiKey: "fc-YOUR-API-KEY",
});
// ウェブサイトをスクレイピングする:
const doc = await firecrawl.scrape('https://firecrawl.dev', { formats: ['markdown', 'html'] });
console.log(doc);
```
```bash
# 開始にAPI keyは不要です — より高いRate Limitsを利用するには -H "Authorization: Bearer $FIRECRAWL_API_KEY" を追加してください:
curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \
-H "Content-Type: application/json" \
-d '{
"url": "https://firecrawl.dev",
"formats": ["markdown", "html"]
}'
```
```bash
# Scrape a URL and get markdown
firecrawl https://firecrawl.dev
# 複数のフォーマットで取得（JSONを返す）
firecrawl https://firecrawl.dev --format markdown,html,links --pretty
```
SDK は data オブジェクトを直接返します。cURL は以下に示すとおり、ペイロードをそのまま返します。
```json
{
"success": true,
"data" : {
"markdown": "Launch Week I が開幕！[2日目のリリースを見る 🚀](https://www.firecrawl.dev/blog/launch-week-i-day-2-doubled-rate-limits)[💥 2か月無料をゲット...",
"html": "
## Interact [#interact]
ページをスクレイピングした後も、そのまま操作を続けられます。ボタンのクリック、フォームへの入力、動的コンテンツの抽出、さらに深い階層への移動が可能です。やりたいことを平易な英語で指定することも、完全に制御するためのコードを書くこともできます。すべてのオプションについては、[Interact 機能のドキュメント](/ja/features/interact)を参照してください。
Python
Node
cURL
CLI
```python
from firecrawl import Firecrawl
app = Firecrawl(
# 開始にAPIキーは不要です — より高いレート制限のために追加してください:
# 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)
```
```js
import { Firecrawl } from 'firecrawl';
const app = new Firecrawl({
// 開始にAPIキーは不要です — レート制限を引き上げるには追加してください:
// apiKey: 'fc-YOUR-API-KEY',
});
// 1. Scrape Amazon's homepage
const result = await app.scrape('https://www.amazon.com', { formats: ['markdown'] });
const scrapeId = result.metadata?.scrapeId;
// 2. Interact — search for a product and get its price
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. Stop the session
await app.stopInteraction(scrapeId);
```
```bash
# 1. Amazonのホームページをスクレイピングする
# 開始時にAPI keyは不要 — より高いレート制限を利用するには -H "Authorization: Bearer $FIRECRAWL_API_KEY" を追加してください:
RESPONSE=$(curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \
-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.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \
-H "Content-Type: application/json" \
-d '{"prompt": "Search for iPhone 16 Pro Max"}'
curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \
-H "Content-Type: application/json" \
-d '{"prompt": "Click on the first result and tell me the price"}'
# 3. セッションを停止する
curl -s -X DELETE "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact"
```
```bash
# 1. AmazonのホームページをスクレイピングするスクレイピングIDは自動的に保存されます）
firecrawl scrape https://www.amazon.com
# 2. 操作する — 商品を検索して価格を取得する
firecrawl interact "Search for iPhone 16 Pro Max"
firecrawl interact "Click on the first result and tell me the price"
# 3. セッションを停止する
firecrawl interact stop
```
```json title="Response"
{
"success": true,
"cdpUrl": "wss://browser.firecrawl.dev/...",
"liveViewUrl": "https://liveview.firecrawl.dev/...",
"interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",
"output": "The iPhone 16 Pro Max (256GB) is priced at $1,199.00.",
"exitCode": 0,
"killed": false
}
```
***
## その他の機能 [#その他の機能]
AI を活用した自律的な Web データ収集
クリック、フォーム入力、動的コンテンツを抽出
非同期イベント配信
インタラクティブなワークフロー向けのマネージドブラウザセッション
Web サイト上のすべての URL を検出
サイト全体からコンテンツを再帰的に収集
***
## リソース [#リソース]
インタラクティブな実行例付きの詳細なAPIドキュメント
Python、Node.js、CLI、コミュニティ製SDK
Firecrawlをセルフホストする、またはプロジェクトに貢献する
LangChain、LlamaIndex、OpenAI など