# Mastra (/ja/quickstarts/mastra)
Related: [Node.js](/ja/quickstarts/nodejs.md), [Next.js](/ja/quickstarts/nextjs.md), [Express](/ja/quickstarts/express.md), [NestJS](/ja/quickstarts/nestjs.md), [Fastify](/ja/quickstarts/fastify.md), [Hono](/ja/quickstarts/hono.md)
## 前提条件 [#前提条件]
* Node.js 22.13+
* Firecrawl APIキー — [無料で取得できます](https://www.firecrawl.dev/app/api-keys)
* 対応している[Mastraモデルプロバイダー](https://mastra.ai/models)のAPIキー
* 既存のMastraプロジェクト — まだない場合は、[Mastraクイックスタート](https://mastra.ai/guides/getting-started/quickstart)に従ってセットアップしてください
## SDKをインストール [#sdkをインストール]
```bash
npm install firecrawl
```
## APIキーを設定する [#apiキーを設定する]
`.env`にAPIキーを追加します:
```bash
FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
## Firecrawl ツールを作成する [#firecrawl-ツールを作成する]
search と スクレイピング を Mastra ツールとして利用できるようにするため、`src/mastra/tools/firecrawl.ts` を作成します。
```typescript
import { Firecrawl } from "firecrawl";
import { createTool } from "@mastra/core/tools";
import { z } from "zod";
const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY! });
export const firecrawlSearch = createTool({
id: "firecrawl-search",
description: "Search the web and return top results.",
inputSchema: z.object({ query: z.string().min(1) }),
outputSchema: z.object({
results: z.array(
z.object({
title: z.string().nullable(),
url: z.string(),
}),
),
}),
execute: async ({ query }) => {
const results = await firecrawl.search(query, { limit: 3 });
return {
results: (results.web ?? []).map((item) => ({
title: item.title ?? null,
url: item.url,
})),
};
},
});
export const firecrawlScrape = createTool({
id: "firecrawl-scrape",
description: "Scrape a URL and return markdown content.",
inputSchema: z.object({ url: z.string().url() }),
outputSchema: z.object({ markdown: z.string() }),
execute: async ({ url }) => {
const result = await firecrawl.scrape(url, {
formats: ["markdown"],
onlyMainContent: true,
});
return { markdown: result.markdown ?? "" };
},
});
```
## エージェントを作成 [#エージェントを作成]
`src/mastra/agents/web-agent.ts` を作成し、Firecrawl のツールを設定します。
```typescript
import { Agent } from "@mastra/core/agent";
import { firecrawlSearch, firecrawlScrape } from "../tools/firecrawl";
export const webAgent = new Agent({
id: "web-agent",
name: "Web Agent",
instructions:
"Use Firecrawl tools to search and scrape web pages, then summarize the results.",
model: "openai/gpt-5.4",
tools: { firecrawlSearch, firecrawlScrape },
});
```
## エージェントを登録する [#エージェントを登録する]
`src/mastra/index.ts` で、Mastra インスタンスにエージェントを登録します。
```typescript
import { Mastra } from "@mastra/core";
import { webAgent } from "./agents/web-agent";
export const mastra = new Mastra({
agents: { webAgent },
});
```
## Studioでテストする [#studioでテストする]
開発サーバーを起動し、[Mastra Studio](https://mastra.ai/docs/studio/overview)を開きます：
```bash
mastra dev
```
**Web Agent** を開き、次のようなプロンプトを試してください。
* "Firecrawl の最新の変更履歴を見つけて、直近のリリースを要約してください。"
* "Firecrawl の料金を検索し、プランの種類を抽出してください。"
## セルフホスト版 Firecrawl [#セルフホスト版-firecrawl]
Firecrawl をローカルで実行する場合は、`FIRECRAWL_API_URL` を設定し、`apiUrl` をクライアントに渡してください:
```typescript
const firecrawl = new Firecrawl({
apiKey: process.env.FIRECRAWL_API_KEY!,
apiUrl: process.env.FIRECRAWL_API_URL,
});
```
## 次のステップ [#次のステップ]
フォーマット、アクション、プロキシを含む、すべてのスクレイピングのオプション
ウェブを検索してページ全体のコンテンツを取得
エージェント に Firecrawl のエンドツーエンド処理を任せる
クロール、map、バッチスクレイプなどを含む SDK の完全なリファレンス