Scrapear o Etsy - Firecrawl Docs

O Etsy é um marketplace global de itens únicos e criativos. Este guia mostra como extrair listagens de produtos, informações de lojas, avaliações e itens em alta usando o Firecrawl.

Configuração

npm install firecrawl zod

Visão geral

Ao fazer scraping no Etsy, normalmente você vai querer:

Extrair listagens de produtos e variações
Obter informações da loja e classificações
Monitorar itens e categorias em alta
Acompanhar preços e dados de vendas
Extrair avaliações de clientes

Scraping no modo JSON

Extraia dados estruturados de listagens usando esquemas Zod.

import { Firecrawl } from 'firecrawl';
import { z } from 'zod';

// Definir esquema Zod
const ListingSchema = z.object({
    title: z.string(),
    price: z.string(),
    shopName: z.string(),
    rating: z.number()
});

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

const result = await firecrawl.scrape('https://www.etsy.com/listing/1844315896/handmade-925-sterling-silver-jewelry-set', {
    formats: [{
        type: 'json',
        schema: z.toJSONSchema(ListingSchema)
    }],
});

// Analisar e validar com Zod
const jsonData = typeof result.json === 'string' ? JSON.parse(result.json) : result.json;
const validated = ListingSchema.parse(jsonData);

console.log('✅ Dados da listagem validados:');
console.log(validated);

Busca

Encontre produtos no marketplace da Etsy.

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

const searchResult = await firecrawl.search('handmade jewelry site:etsy.com', {
    limit: 10,
    sources: [{ type: 'web' }], // { type: 'news' }, { type: 'images' }
    scrapeOptions: {
        formats: ['markdown']
    }
});

console.log(searchResult);

scraping

Extraia os dados de uma única listagem de produto no Etsy.

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

const result = await firecrawl.scrape('https://www.etsy.com/listing/1844315896/handmade-925-sterling-silver-jewelry-set', {
    formats: ['markdown'], // ex.: html, links, etc.
    onlyMainContent: true
});

console.log(result);

Map

Descubra todas as URLs disponíveis em uma loja ou categoria no Etsy. Observação: o Map retorna apenas URLs, sem conteúdo.

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

const mapResult = await firecrawl.map('https://www.etsy.com/shop/YourShopName');

console.log(mapResult.links);
// Retorna um array de URLs sem conteúdo

Crawl

Rastreie várias páginas de uma loja ou categoria no Etsy.

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

const crawlResult = await firecrawl.crawl('https://www.etsy.com/c/jewelry', {
    limit: 10,
    scrapeOptions: {
        formats: ['markdown']
    }
});

console.log(crawlResult.data);

scraping em Lote

Extraia dados de várias URLs de listagens do Etsy simultaneamente.

import { Firecrawl } from 'firecrawl';

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

// Aguardar conclusão
const job = await firecrawl.batchScrape([
    'https://www.etsy.com/listing/1844315896/handmade-925-sterling-silver-jewelry-set',
    'https://www.etsy.com/market/handmade_jewelry',
    'https://www.etsy.com/market/jewelry_handmade'],
    {
        options: {
            formats: ['markdown']
        },
        pollInterval: 2,
        timeout: 120
    }
);


console.log(job.status, job.completed, job.total);

console.log(job);

​Configuração

​Visão geral

​Scraping no modo JSON

​Busca

​scraping

​Map

​Crawl

​scraping em Lote

Configuração

Visão geral

Scraping no modo JSON

Busca

scraping

Map

Crawl

scraping em Lote