LibreBOR és una plataforma per consultar i analitzar el Boletín Oficial del Registro Mercantil.
LibreBOR (abans coneguda com a LibreBORME) va néixer amb la intenció d’“obrir” les dades del Registre Mercantil d’Espanya. Aprofitant que des del 2009 es publica el BORME en format electrònic, LibreBOR s’encarrega de llegir-lo cada matí i afegir els últims canvis a la seva base de dades.
D’aquesta manera, tu pots fer cerques semàntiques, rebre notificacions i utilitzar les dades fàcilment i pel que vulguis.
Registre Mercantil
El Registre Mercantil és una institució oficial que s’encarrega de donar publicitat sobre les persones físiques i jurídiques, que intervenen en el tràfic mercantil.
S’inscriuen actes dels empresaris, siguin individuals o societats, de tal manera que puguin ser coneguts per aquelles persones que contractin serveis (proveïdors, bancs, etc), així com per possibles inversors (com per exemple accionistes), endemés de per entitats públiques amb les quals tinguin relació (Seguretat Social, AEAT, etc.).
En l’àmbit d’investigació, es pot utilitzar el Registre Mercantil per localitzar empreses i els seus càrrecs més importants.
LibreBOR Web
LibreBOR facilita tota la cerca al Registre Mercantil: https://librebor.me/
Per utilitzar-lo clica “Comienza a usarlo”. Pots veure que hi ha un cercador a la part superior, que pots utilitzar per buscar empreses o persones:
Per exemple, si busques don piso apareixen els següents resultats:
Nota: és molt normal trobar noms d’empreses que són la mateixa però varien una mica o noms de persones que són la mateixa però tenen dues entrades perquè en una hi ha el segon nom i a l’altra no o tenen els cognoms i nom girats.
A l’exemple apareixen 3 empreses i cap persona. Si cliques a Don Piso SL veuràs la informació de l’empresa detallada. Normalment hi ha els següents apartats:
- Resum i informació general
- Càrrecs directius
- Anuncis a bolletins oficials
- Persones relacionades
- Societats relacionades
- BORMEs relacionats
La taula de càrrecs directius està dividida en les següents columnes:
- Càrrec: càrrec que té dins de l’empresa. La majoria estan abreujats i els hauràs de deduir. No han publicat cap document que expliqui que vol dir cada càrrec.
- Persona física/jurídica: nom de la persona o empresa que té el càrrec assignat.
- Desde: data del nomenament.
- Hasta data en la que va deixar el càrrec.
Al final de la taula, podràs ampliar-la clicant “Ver más” i veure els càrrecs no vigents:
Pots d’accedir als detalls des del buscador i també pots clicar directament a qualsevol dels noms de la taula.
En aquest exemple si cliquessobre l’administrador únic Figueras Costa Bruno, obtindràs els seus detalls:
Pots veure fàcilment com no només té un càrrec directiu a Don Piso SL, sinó que també té altres càrrecs a moltes empreses relacionades amb la compra venda d’actius immobiliaris.
A més a més, pots exportar les taules a CSV per poder veure-ho en un Excel o tractar les dades amb una eina personalitzada:
Fàcilment pots fer un mapa de relacions entre empreses i càrrecs directius que et serviran no només per contextualitzar, sinó per saber qui controla realment l’empresa.
LibreBOR API
LibreBOR no només ofereix el servei web, sinó que també disposa d’API. Una API són unes crides específiques que pots fer en diversos llenguatges de programació. El resultat serà el mateix que si ho busques a través de la web, però l’obtindràs amb un format més tractable si estàs desenvolupant un programa.
A continuació posem uns exemples en Python perquè vegis com funciona l’API.
Si vols buscar a una persona, pots fer-ho de la següent manera:
1
2
3
4
5
6
7
8
9
10
import requests, json
# Buscar persona
pagina = 1
nom = 'Rodrigo Rato'
tipus = 'persona'
url = 'https://libreborme.net/borme/api/v1/{}/search/?q={}&page={}'.format(tipus,nom,pagina)
resultat_cerca = json.loads(requests.get(url).text)
print (json.dumps(resultat_cerca, indent=4, sort_keys=True))
El resultat obtingut està en format JSON, un format que et permet tractar les dades amb molta facilitat. Si el mostres per pantalla té aquesta pinta:
Com pots veure, el JSON està format per un vector que conté un JSON de cada resultat. Aquest està compost pels següents paràmetres:
- name: nom de la persona buscada
- resource_uri: part de l’URL que hauràs d’utilitzar si vols obtenir els detalls
- slug: part final de l’URI
Per obtenir els detalls de la persona, només has de fer una petició afegint l’URI obtinguda:
1
2
3
4
5
6
7
import requests, json
# Obtenir detalls
uri = '/borme/api/v1/persona/rato-figaredo-rodrigo/'
url = 'https://libreborme.net{}'.format(uri)
resultat_detalls = json.loads(requests.get(url).text)
print (json.dumps(resultat_detalls, indent=4, sort_keys=True))
El resultat està format per un JSON que conté els següents paràmetres:
- cargos_actuales: vector que conté un JSON de cada un dels càrrecs vigents
- cargos_historial: vector que conté un JSON de cada un dels càrrecs no vigents
- date_updated: data en el que s’ha actualitzat per última vegada
- in_bormes: enllaços als BORMEs relacionats
- in_companies: empreses relacionades
- name: nom de la persona
- resource_uri: part de l’URL que hauràs d’utilitzar si vols obtenir els detalls
- slug: part final de l’URI
Per altra banda, si vols buscar una empresa el sistema és gairebé igual, però els resultats varien una mica:
1
2
3
4
5
6
7
8
9
10
import requests, json
# Buscar empresa
pagina = 1
nom = 'idealista'
tipus = 'empresa'
url = 'https://libreborme.net/borme/api/v1/{}/search/?q={}&page={}'.format(tipus,nom,pagina)
resultat_cerca = json.loads(requests.get(url).text)
print (json.dumps(resultat_cerca, indent=4, sort_keys=True))
El resultat obtingut és el mateix que si busques una persona:
Per obtenir els detalls de l’empresa, només has de fer una petició afegint l’URI obtinguda:
1
2
3
4
5
6
7
import requests, json
# Obtenir detalls
uri = '/borme/api/v1/empresa/idealista-international/'
url = 'https://libreborme.net{}'.format(uri)
resultat_detalls = json.loads(requests.get(url).text)
print (json.dumps(resultat_detalls, indent=4, sort_keys=True))
El resultat està format per un JSON que conté els següents paràmetres:
- anuncia: vector que conté un JSON per cada anunci
- cargos_actuales_c: vector que conté un JSON de cada un dels càrrecs actuals que són empreses
- cargos_actuales_p: vector que conté un JSON de cada un dels càrrecs actuals que són persones
- cargos_historial_c: vector que conté un JSON de cada un dels càrrecs no vigents que són empreses
- cargos_historial_p: vector que conté un JSON de cada un dels càrrecs no vigents que són persones
- date_creation: data de creació de l’empresa
- date_extinction: data tancament empresa
- date_updated: data en el que s’ha actualitzat per última vegada
- in_bormes: enllaços als BORMEs relacionats
- is_active: si l’empresa segueix activa
- name: nom de la persona
- resource_uri: part de l’URL que hauràs d’utilitzar si vols obtenir els detalls
- slug: part final de l’URI
- type: tipus d’empresa (SA, SL…)
Amb aquestes quatre peticions pots fer un programa que busqui i/o automatitzi l’obtenció de detalls de persones i empreses. Ja més elaborat, també pots arribar a crear grafs si obtens les dades de manera recursiva.