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

# Neuron AI

> Busca en la web y lee páginas en formato Markdown desde agentes de Neuron AI en PHP

<Note>
  **Documentación oficial de Neuron AI:** [docs.neuron-ai.dev/agent/tools](https://docs.neuron-ai.dev/agent/tools)

  Dota a tus agentes en PHP de búsqueda web y lectura de páginas con Firecrawl
</Note>

<h2 id="overview">
  Descripción general
</h2>

[Neuron AI](https://neuron-ai.dev) es un framework agéntico para PHP. Incluye un toolkit de Firecrawl que permite a un agente de Neuron buscar en la web y leer cualquier página como Markdown limpio durante una ejecución.

<h2 id="quick-start">
  Inicio rápido
</h2>

1. Instala Neuron AI 4.1.3 o una versión posterior:

```bash theme={null}
composer require neuron-core/neuron-ai:^4.1.3
```

2. Obtén una clave de API desde tu [Dashboard de Firecrawl](https://www.firecrawl.dev/app/api-keys) y configúrala como `FIRECRAWL_API_KEY`
3. Añade el toolkit a tu agente:

```php theme={null}
namespace App\Neuron;

use NeuronAI\Agent\Agent;
use NeuronAI\Tools\Toolkits\Firecrawl\FirecrawlToolkit;

class ResearchAgent extends Agent
{
    ...

    protected function tools(): array
    {
        return [
            FirecrawlToolkit::make(
                key: getenv('FIRECRAWL_API_KEY')
            ),
        ];
    }
}
```

<h2 id="tools">
  Herramientas
</h2>

| Herramienta | Nombre que ve el agente | Qué hace |
| - | - | - |
| `FirecrawlSearchTool` | `web_search` | Busca en la web, o en noticias si el agente lo pide, con un intervalo de tiempo opcional |
| `FirecrawlScrapeTool` | `url_reader` | Devuelve el contenido principal de una página en Markdown |

También puedes añadir cualquiera de las dos herramientas por separado, por ejemplo, `FirecrawlSearchTool::make(key: getenv('FIRECRAWL_API_KEY'))`.

<h2 id="get-page-content-with-each-search-result">
  Obtén el contenido de la página con cada resultado de búsqueda
</h2>

De forma predeterminada, una búsqueda devuelve el título, la URL y la descripción de cada resultado. Si pasas `scrapeOptions`, cada resultado incluye además la página completa en Markdown, así que el agente no necesita hacer una segunda llamada para leerla:

```php theme={null}
use NeuronAI\Tools\Toolkits\Firecrawl\FirecrawlSearchTool;

FirecrawlSearchTool::make(key: getenv('FIRECRAWL_API_KEY'))->withOptions([
    'limit' => 5,
    'scrapeOptions' => [
        'formats' => ['markdown'],
        'onlyMainContent' => true,
    ],
]);
```

`withOptions()` sustituye los valores predeterminados y acepta cualquier [parámetro de búsqueda](/es/api-reference/endpoint/search). La consulta de búsqueda siempre la proporciona el agente.

<h2 id="resources">
  Recursos
</h2>

* [Herramientas y toolkits de Neuron AI](https://docs.neuron-ai.dev/agent/tools)
* [Documentación de búsqueda de Firecrawl](/es/features/search)
* [Documentación de scraping de Firecrawl](/es/features/scrape)


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