# Spring Boot (/ja/quickstarts/spring-boot)
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)
## 前提条件 [#前提条件]
* Java 17+ と Spring Boot 3+
* Firecrawl APIキー — [無料で取得できます](https://www.firecrawl.dev/app/api-keys)
## 依存関係を追加する [#依存関係を追加する]
```kotlin
dependencies {
implementation("com.firecrawl:firecrawl-java:1.2.0")
}
```
```xml
com.firecrawl
firecrawl-java
1.2.0
```
## 設定 [#設定]
`application.properties` にAPIキーを追加します:
```properties
firecrawl.api-key=${FIRECRAWL_API_KEY}
```
または、環境変数として設定します：
```bash
export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
## 設定Beanを作成する [#設定beanを作成する]
`FirecrawlConfig.java` を作成します。
```java
import com.firecrawl.client.FirecrawlClient;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class FirecrawlConfig {
@Bean
public FirecrawlClient firecrawlClient(
@Value("${firecrawl.api-key}") String apiKey) {
return FirecrawlClient.builder()
.apiKey(apiKey)
.build();
}
}
```
## RESTコントローラーを作成 [#restコントローラーを作成]
`FirecrawlController.java` を作成します。
```java
import com.firecrawl.client.FirecrawlClient;
import com.firecrawl.models.Document;
import com.firecrawl.models.SearchData;
import com.firecrawl.models.SearchOptions;
import com.firecrawl.models.ScrapeOptions;
import com.firecrawl.models.BrowserExecuteResponse;
import org.springframework.web.bind.annotation.*;
import java.util.List;
import java.util.Map;
@RestController
@RequestMapping("/api")
public class FirecrawlController {
private final FirecrawlClient firecrawl;
public FirecrawlController(FirecrawlClient firecrawl) {
this.firecrawl = firecrawl;
}
@PostMapping("/search")
public SearchData search(@RequestBody Map body) {
return firecrawl.search(
(String) body.get("query"),
SearchOptions.builder()
.limit((int) body.getOrDefault("limit", 5))
.build()
);
}
@PostMapping("/scrape")
public Map scrape(@RequestBody Map body) {
Document doc = firecrawl.scrape(body.get("url"));
return Map.of(
"markdown", doc.getMarkdown(),
"metadata", doc.getMetadata()
);
}
@PostMapping("/interact")
public Map interact(@RequestBody Map body) {
Document doc = firecrawl.scrape(body.get("url"),
ScrapeOptions.builder().formats(List.of((Object) "markdown")).build());
String scrapeId = (String) doc.getMetadata().get("scrapeId");
BrowserExecuteResponse response = firecrawl.interact(scrapeId,
body.getOrDefault("code", "const title = await page.title(); console.log(title);"));
firecrawl.stopInteractiveBrowser(scrapeId);
return Map.of("result", response.getStdout());
}
}
```
## 実行してみる [#実行してみる]
```bash
./gradlew bootRun
```
## 試す [#試す]
```bash
# ウェブを検索する
curl -X POST http://localhost:8080/api/search \
-H "Content-Type: application/json" \
-d '{"query": "firecrawl web scraping"}'
# ページをスクレイピングする
curl -X POST http://localhost:8080/api/scrape \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}'
# ページをInteractする
curl -X POST http://localhost:8080/api/interact \
-H "Content-Type: application/json" \
-d '{"url": "https://www.amazon.com", "code": "const title = await page.title(); console.log(title);"}'
```
## 次のステップ [#次のステップ]
Web を検索してページ全体のコンテンツを取得
フォーマット、アクション、プロキシなど、スクレイピングのオプションを網羅
クリック、フォーム入力、動的コンテンツの抽出
クロール、map、バッチスクレイプなどを含む SDK の完全リファレンス