# Java (/pt-BR/quickstarts/java)
Related: [Node.js](/pt-BR/quickstarts/nodejs.md), [Next.js](/pt-BR/quickstarts/nextjs.md), [Express](/pt-BR/quickstarts/express.md), [NestJS](/pt-BR/quickstarts/nestjs.md), [Fastify](/pt-BR/quickstarts/fastify.md), [Hono](/pt-BR/quickstarts/hono.md)
## Pré-requisitos [#pré-requisitos]
* Java 11+
* Uma chave de API do Firecrawl — [obtenha uma grátis](https://www.firecrawl.dev/app/api-keys)
## Instale o SDK [#instale-o-sdk]
```kotlin
dependencies {
implementation("com.firecrawl:firecrawl-java:1.2.0")
}
```
```xml
com.firecrawl
firecrawl-java
1.2.0
```
## Fazer uma busca na web [#fazer-uma-busca-na-web]
```java
import com.firecrawl.client.FirecrawlClient;
import com.firecrawl.models.SearchData;
import com.firecrawl.models.SearchOptions;
public class Main {
public static void main(String[] args) {
FirecrawlClient client = FirecrawlClient.builder()
.apiKey("fc-YOUR-API-KEY")
.build();
SearchData results = client.search(
"firecrawl web scraping",
SearchOptions.builder().limit(5).build()
);
if (results.getWeb() != null) {
for (var result : results.getWeb()) {
System.out.println(result.get("title") + " - " + result.get("url"));
}
}
}
}
```
## Fazer scraping de uma página [#fazer-scraping-de-uma-página]
```java
import com.firecrawl.models.Document;
Document doc = client.scrape("https://example.com");
System.out.println(doc.getMarkdown());
```
```json
{
"markdown": "# Example Domain\n\nThis domain is for use in illustrative examples...",
"metadata": {
"title": "Example Domain",
"sourceURL": "https://example.com"
}
}
```
## Interagir com uma página [#interagir-com-uma-página]
Abra uma sessão do navegador, execute código Playwright nela e feche-a ao terminar:
```java
import com.firecrawl.models.ScrapeOptions;
import com.firecrawl.models.BrowserExecuteResponse;
import java.util.List;
Document doc = client.scrape("https://www.amazon.com",
ScrapeOptions.builder().formats(List.of((Object) "markdown")).build());
String scrapeId = (String) doc.getMetadata().get("scrapeId");
BrowserExecuteResponse run = client.interact(scrapeId,
"const title = await page.title(); console.log(title);");
System.out.println(run.getStdout());
client.stopInteractiveBrowser(scrapeId);
```
## Variável de ambiente [#variável-de-ambiente]
Em vez de passar `apiKey` diretamente, defina a variável de ambiente `FIRECRAWL_API_KEY`:
```bash
export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
```java
FirecrawlClient client = FirecrawlClient.fromEnv();
```
## Próximos passos [#próximos-passos]
Fazer uma busca na web e obter o conteúdo completo da página
Todas as opções de scraping, incluindo formatos, ações e proxies
Clique, preencha formulários e extraia conteúdo dinâmico
Referência completa do SDK com rastreamento, map, extração em lote e mais