> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Apify

> Extrai dados estruturados da web e integra-os no teu projeto

O Macaly consegue extrair dados estruturados de toda a web e integrá-los diretamente no teu projeto. Pede listagens de produtos, avaliações ou publicações de redes sociais, e o agente recolhe os dados e transforma-os em páginas, catálogos ou feeds.

<Callout icon="user">
  Disponível em todos os planos
</Callout>

## O que é a Apify?

A Apify é uma plataforma de web scraping, ou seja, o processo de recolher dados de sites de forma automática em vez de os copiar à mão. Faz isto através de **actors**: ferramentas prontas a usar que conseguem extrair dados de um site ou plataforma específica, do Instagram à Amazon, passando pelo Google Maps.

O Macaly trata da Apify por ti. Não precisas de uma conta Apify, nem de saber como isto funciona. Descreves os dados que queres e o agente escolhe o actor certo e trata do resto.

## O que podes criar

Muitos projetos úteis começam com dados que já existem algures na internet. O agente recolhe-os por ti e transforma-os em algo estruturado: uma página, um catálogo ou um painel. Alguns exemplos do que podes criar:

* **Site empresarial.** Cria um site a partir do teu perfil do Google Maps. O agente extrai o essencial, incluindo as tuas fotos, horário de funcionamento, morada e avaliações.
* **Painel de redes sociais.** Extrai publicações e dados de perfil de plataformas sociais como o Instagram para um painel que mostra o desempenho do teu conteúdo.
* **CV ou portefólio.** Partilha um link para o teu perfil do LinkedIn e o agente extrai a tua experiência, competências e outros detalhes para criar um portefólio ou CV pronto a publicar.
* **Site de arrendamento.** Pega no anúncio do teu imóvel no Airbnb ou Booking e transforma-o num site próprio, independente, com descrições, fotos e avaliações.
* **Catálogo de produtos.** Extrai produtos de uma loja como a Amazon ou o eBay e transforma-os num catálogo funcional com filtros e páginas de detalhe.

O agente consegue extrair dados de muitas plataformas conhecidas, incluindo Instagram, Amazon, Google Maps, Zillow, TikTok, Facebook, X, YouTube, eBay, Booking, Airbnb, Yelp, Trustpilot, Reddit, sites de emprego, sites de avaliações e diretórios de empresas.

## Como funciona

Não precisas de configurar nada. Basta descrever os dados que queres como parte do que estás a criar:

```
Cria um painel com o desempenho do meu Instagram. Extrai as
minhas publicações mais recentes deste perfil [url] com os
respetivos gostos, comentários e legendas.
```

```
Estou a criar um site de portefólio. Aqui está o meu perfil do
LinkedIn [url], usa-o para preencher a minha experiência e
competências.
```

<Steps>
  <Step title="O agente escolhe uma ferramenta">
    Encontra um actor adequado para a plataforma que estás a visar, escolhendo um popular e testado. Se já tiveres um actor específico em mente, podes nomeá-lo e o agente vai usá-lo.
  </Step>

  <Step title="Confirmas a ação">
    Antes de carregar seja o que for, o agente pausa e pede-te confirmação. Vais ver no chat uma breve confirmação a mostrar o que vai ser carregado e quantos créditos a ação poderá usar. Escolhe **Yes / Load data** para avançar, ou **No / Skip** para cancelar.

    <img src="https://mintcdn.com/macaly-41b1d3e9/DUgVHLByMA54GOYh/images/integrations_apify_02.png?fit=max&auto=format&n=DUgVHLByMA54GOYh&q=85&s=911f4fa134ec93cf7a187ab5c19f8de4" alt="Confirmação de extração da Apify" width="1200" height="800" data-path="images/integrations_apify_02.png" />
  </Step>

  <Step title="O agente cria com os dados">
    Depois de confirmares, o agente recolhe os dados e usa-os para criar o teu projeto, da mesma forma que trabalha com qualquer outro conteúdo.
  </Step>
</Steps>

## Créditos

Extrair dados consome créditos, porque obtém dados reais da internet através da Apify. O custo exato depende da quantidade de dados extraídos, por isso pode variar de um pedido para outro.

O agente pede sempre confirmação antes de começar a extrair dados. Um único pedido nunca excederá **500 mil créditos**. Nada é carregado, e nenhum crédito é consumido, até dizeres que sim.

Confirmas cada ação individualmente. Se o agente precisar de tentar uma ferramenta diferente ou extrair mais dados, pede-te confirmação outra vez.

## Boa a saber

* **Não é preciso configurar nada.** Não precisas de uma conta Apify, de uma chave API, nem de qualquer ligação. Basta pedir ao agente os dados que queres.
* **O agente escolhe a ferramenta.** Escolhe um actor adequado por ti, mas se preferires, podes escolher um específico.
* **É-te sempre pedida confirmação primeiro.** O agente nunca extrai dados sem a tua confirmação. Um único pedido nunca excederá **500 mil créditos**.
* **Algumas fontes podem exigir início de sessão.** As ferramentas que exigem que inicies sessão com a tua própria conta são ignoradas automaticamente.
* **Se nenhuma ferramenta servir, o agente adapta-se.** Quando não existe uma ferramenta adequada para um site, o agente tenta ler o conteúdo de outras formas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.