# BORME Scraper Pro (`startquicklabs/borme-scraper-pro`) Actor

Este actor permite la descarga estructurada de datos del Boletín Oficial del Registro Mercantil (BORME)

- **URL**: https://apify.com/startquicklabs/borme-scraper-pro.md
- **Developed by:** [Start Quick Labs](https://apify.com/startquicklabs) (community)
- **Categories:** Developer tools, Automation, Other
- **Stats:** 18 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.25 / 1,000 rows

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Descarga fácil de datos estructurados del Registro Mercantil (BORME) - Datos de Empresas España

**Extracción automatizada y verificada de datos del Boletín Oficial del Registro Mercantil (BORME).**

Este Actor de Apify es la solución profesional para obtener datos estructurados de empresas españolas. Descarga, procesa y digitaliza diariamente los PDFs oficiales del BORME, permitiéndote acceder a información crítica de negocio sin barreras técnicas.

### 🚀 ¿Qué datos puedes obtener?

Extraemos información detallada que normalmente está oculta en textos no estructurados:

- **Identificación**: Nombre de la Empresa (Razón Social), **Tipo de Sociedad** (S.A., S.L...) y Provincia.
- **Actividad**: Objeto Social completo y Códigos CNAE.
- **Financiero**: Capital Social Suscrito y Desembolsado (Valores numéricos listos para análisis).
- **Legal**: Detalle de Actos Inscritos (Constitución, Ampliación de Capital, Disolución...).
- **Contacto**: Domicilio Social completo.
- **Órganos Sociales**: Lista estructurada de Administradores, Apoderados y Consejeros (`Nombramientos`).

### 💼 Casos de Uso

#### 1. Generación de Leads B2B

Detecta **nuevas empresas constituidas** en tu provincia cada mañana. Filtra por actividad (CNAE) para contactar solo a tus clientes potenciales ideales (software, construcción, hostelería...).

#### 2. Análisis de Riesgos y Compliance

Monitorea **cambios en la administración** o **reducciones de capital** en tu cartera de clientes o proveedores para anticipar riesgos financieros.

#### 3. Inteligencia de Mercado

Analiza tendencias de creación de empresas por sectores y zonas geográficas en tiempo real.

### 💡 Ventajas Competitivas

- **Cobertura Total**: Todas las provincias de España (Madrid, Barcelona, Valencia, Sevilla, Bilbao...).
- **Datos Estructurados**: Olvídate de parsear PDFs. Recibe JSON/Excel/CSV listos para usar.
- **Anti-Bloqueo**: Infraestructura robusta con Proxies y esperas inteligentes para garantizar la descarga.
- **Económico**: Paga solo por los datos que obtienes (PPR). Sin tarifas fijas ocultas.

### 📥 Parámetros de Entrada

Configuración sencilla y potente:

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `fechaInicio` | Texto | **Opcional**. Fecha de inicio (Selector de Fecha). Si se omite, se calculará `Hoy - Días a Procesar`. |
| `diasProcesar` | Número | Días consecutivos a descargar. Por defecto **1** (Solo hoy o solo la fecha de inicio). |
| `provincia` | Selección | Filtra por provincia (Ej: `MADRID`, `BARCELONA`). Déjalo vacío para descargar **toda España**. |
| `configuracionProxy` | Proxy | **Recomendado**: Usa "Automatic Proxy" para máxima fiabilidad. |
| `maxSegundosEspera` | Número | Tiempo máximo de espera entre descargas. (El sistema respeta un mínimo de 6s automáticamente). |

### 📤 Ejemplo de Datos (JSON)

Cada registro devuelto sigue este formato estandarizado:

```json
{
  "id_anuncio": "123456",
  "empresa": "EMPRESA EJEMPLO INNOVADORA S.L.",
  "tipo_sociedad": "Sociedad Limitada",
  "tipo": "Constitución",
  "texto_completo": "Constitución. Comienzo de operaciones: 2026. Objeto social: Desarrollo de software...",
  "datos_registrales": "Tomo 123, Folio 45...",
  "objeto_social": "Desarrollo de soluciones tecnológicas y consultoría...",
  "domicilio": "CALLE GRAN VÍA 1 (MADRID)",
  "capital": 3000.0,
  "capital_act": 3000.0,
  "cnae": "6201",
  "nombramientos": "GARCIA PEREZ JUAN|LOPEZ MARTINEZ ANA",
  "provincia_anuncio": "MADRID",
  "fecha_publicacion": "2026-02-02"
}
```

#### Ejemplo Visual (CSV / Excel)

| empresa | tipo\_sociedad | tipo | capital | cnae | nombramientos | provincia\_anuncio |
|---------|---------------|------|---------|------|---------------|-------------------|
| TECH SOLUTIONS S.L. | Sociedad Limitada | Constitución | 3000.0 | 6201 | GARCIA PEREZ JUAN... | MADRID |
| CONSTRUCCIONES ALFA | Sociedad Anónima | Nombramiento | ... | 4120 | LOPEZ RUIZ ANA... | BARCELONA |
| HOSTELERIA BETIS | Sociedad Limitada | Ampliación | 15000.0 | 5610 | MARTINEZ SOLER... | SEVILLA |
| ... | ... | ... | ... | ... | ... | ... |

### ❓ Preguntas Frecuentes (FAQ)

**¿Con qué frecuencia se actualizan los datos?**
El actor extrae los datos directamente de la fuente oficial (BOE).

**¿Puedo filtrar por CNAE antes de descargar?**
Actualmente extraemos todo y tú puedes filtrar el dataset resultante (JSON/Excel) por el campo `cnae` o `objeto_social`.

**¿Qué pasa si el servidor oficial está caído?**
El actor intentará reintentar la conexión, pero depende de la disponibilidad del portal del BOE.

***

**Desarrollado para profesionales que necesitan datos fiables del Registro Mercantil.**

# Actor input Schema

## `fechaInicio` (type: `string`):

Fecha de inicio del procesado. Si se deja vacío, se procesarán los últimos 'Días a Procesar' terminando hoy.

## `diasProcesar` (type: `integer`):

Número de días consecutivos a descargar.

## `provincia` (type: `string`):

Opcional: Extraer solo una provincia específica.

## `configuracionProxy` (type: `object`):

Usa proxies para evitar bloqueos (Recomendado: Apify Proxy Automatic)

## `maxSegundosEspera` (type: `integer`):

Tiempo máximo de espera aleatoria. Mínimo técnico de 6s.

## Actor input object example

```json
{
  "diasProcesar": 1,
  "provincia": "CEUTA",
  "configuracionProxy": {
    "useApifyProxy": true
  },
  "maxSegundosEspera": 30
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset conteniendo los detalles de las empresas (Constituciones, Actos, etc.)

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "configuracionProxy": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("startquicklabs/borme-scraper-pro").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "configuracionProxy": { "useApifyProxy": True } }

# Run the Actor and wait for it to finish
run = client.actor("startquicklabs/borme-scraper-pro").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "configuracionProxy": {
    "useApifyProxy": true
  }
}' |
apify call startquicklabs/borme-scraper-pro --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,startquicklabs/borme-scraper-pro"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/TSuU4D3UmdKnFJaPq/builds/5A6pT5ey8qQQ4sP2O/openapi.json