@altura_ma/onemcp 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 money-maker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,176 @@
+# OneMCP
+
+> Serveur MCP unifié pour les données business publiques France & Europe.
+> Un seul connecteur, des dizaines de sources officielles, agrégation gratuite (sources sans auth) ou avec vos clés.
+> 🌐 [onemcp.fr](https://onemcp.fr)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen)]()
+
+## Pourquoi
+
+Les agents IA ont besoin de données business françaises fiables. Aujourd'hui :
+- Pappers, SocieteInfo, Infonet sont **payants** et juste des wrappers de l'open data public.
+- Les APIs officielles (INSEE, INPI, BODACC, BAN, etc.) sont **gratuites** mais éclatées, formats hétérogènes, OAuth différents.
+
+**Ce serveur agrège tout ça en un seul connecteur MCP avec un schéma canonique unique.**
+
+## Sources couvertes (v0.1 — Layer 1, sans auth)
+
+| Source | Type | Licence |
+|---|---|---|
+| **Recherche d'entreprises (DINUM)** | SIREN/SIRET, dirigeants, finances, BE | Licence Ouverte 2.0 |
+| **BODACC** | Annonces légales, procédures collectives | Licence Ouverte 2.0 |
+| **BAN** | Géocodage adresses françaises | Licence Ouverte 2.0 / ODbL |
+| **Géorisques** | Risques naturels/technologiques par adresse | Licence Ouverte 2.0 |
+| **DVF** | Transactions immobilières (5 ans) | Licence Ouverte 2.0 |
+| **VIES (UE)** | Validation TVA intracommunautaire | Données publiques EU |
+| **GLEIF** | Identifiants LEI mondiaux | CC0 1.0 |
+
+## Tools MCP exposés
+
+Groupés par domaine (13 tools) :
+
+**Entreprise**
+- `company_search` — recherche full-text (nom, dirigeant, SIREN, NAF, dépt)
+- `company_get` — fiche complète par SIREN/SIRET
+- `company_enrich` — fiche + annonces légales + risques + LEI
+
+**Légal**
+- `legal_announcements_search` — annonces BODACC par SIREN ou nom
+- `legal_procedures_check` — procédures collectives en cours
+
+**Géo**
+- `address_search` — géocodage texte → coordonnées
+- `address_reverse` — coordonnées → adresse
+- `address_risks` — risques majeurs à une adresse
+
+**Immobilier**
+- `realestate_transactions` — transactions DVF par commune ou code postal
+
+**Identité**
+- `vat_validate` — validation TVA UE (VIES)
+- `lei_lookup` — fiche LEI par code
+- `lei_search` — recherche LEI par nom
+
+**Méta**
+- `sources_list` — toutes les sources et leurs licences
+
+## Installation
+
+### Claude Desktop / Claude Code (stdio local)
+
+```json
+{
+  "mcpServers": {
+    "business-fr": {
+      "command": "npx",
+      "args": ["-y", "@altura_ma/mcp-business-fr"]
+    }
+  }
+}
+```
+
+Fichiers de config :
+- macOS : `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows : `%APPDATA%\Claude\claude_desktop_config.json`
+- Claude Code : `claude mcp add business-fr -- npx -y @altura_ma/mcp-business-fr`
+
+### Cursor
+
+`.cursor/mcp.json` :
+
+```json
+{
+  "mcpServers": {
+    "business-fr": {
+      "command": "npx",
+      "args": ["-y", "@altura_ma/mcp-business-fr"]
+    }
+  }
+}
+```
+
+### Mode hébergé (Streamable HTTP)
+
+```json
+{
+  "mcpServers": {
+    "business-fr": {
+      "url": "https://mcp.business-fr.dev/mcp",
+      "headers": {
+        "Authorization": "Bearer mk_xxx"
+      }
+    }
+  }
+}
+```
+
+## Développement
+
+```bash
+git clone <repo>
+cd money-maker
+npm install
+npm run build
+npm test
+
+# Local dev avec stdio
+npm run dev
+
+# HTTP mode (Streamable HTTP)
+PORT=3000 npm run start:http
+
+# Inspector officiel pour tester les tools
+npm run inspector
+```
+
+## Schéma canonique
+
+Toutes les réponses retournent un format normalisé avec champ `provenance` :
+
+```ts
+{
+  siren: "552032534",
+  legal_name: "ANTHROPIC",
+  active: true,
+  headquarter: { siret, address: { ... } },
+  officers: [...],
+  financials: [...],
+  provenance: [
+    {
+      source: "recherche-entreprises",
+      source_url: "...",
+      fetched_at: "2026-05-06T22:00:00Z",
+      license: "Licence Ouverte 2.0 (Etalab)"
+    }
+  ],
+  _raw: { ... }  // données brutes de la source
+}
+```
+
+## Architecture
+
+Voir [`docs/architecture.md`](docs/architecture.md).
+
+## Monétisation
+
+Voir [`docs/monetization.md`](docs/monetization.md).
+
+## Conformité
+
+- **RGPD** : ce serveur n'expose que des données publiques. Les données personnelles (dirigeants) sont systématiquement minimisées (date de naissance tronquée à `YYYY-MM`). Documenter votre base légale (intérêt légitime) et l'origine des données auprès des personnes concernées (RGPD Art. 14).
+- **Licences sources** : préservées dans chaque réponse (champ `provenance.license`). Mention obligatoire dans toute réutilisation.
+
+## Roadmap
+
+- [ ] **Layer 2** : connecteurs avec auth (INSEE Sirene, INPI RNE, PISTE/Légifrance, France Travail, Companies House UK, EPO Patents)
+- [ ] **Layer 3** : registres EU (KBO Belgique, Handelsregister DE, KVK NL, BORME ES)
+- [ ] **Mode hébergé multi-tenant** sur Cloudflare Workers + Durable Objects
+- [ ] **Auth & billing** : API keys, Stripe metering
+- [ ] **OAuth 2.1** pour clients enterprise
+- [ ] **Distribution** : Smithery, mcp.so, PulseMCP, npm
+
+## Licence
+
+MIT.

package/dist/cache/index.d.ts

@@ -0,0 +1,12 @@
+export declare class MemoryCache {
+    private readonly store;
+    private readonly maxEntries;
+    constructor(maxEntries?: number);
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T, ttlSeconds: number): void;
+    wrap<T>(key: string, ttlSeconds: number, fn: () => Promise<T>): Promise<T>;
+    clear(): void;
+    size(): number;
+}
+export declare const cache: MemoryCache;
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAKA,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,SAAO;IAI7B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAUlC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAWjD,IAAI,CAAC,CAAC,EACV,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAQb,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;CAGf;AAED,eAAO,MAAM,KAAK,aAAoB,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,44 @@
+export class MemoryCache {
+    store = new Map();
+    maxEntries;
+    constructor(maxEntries = 5000) {
+        this.maxEntries = maxEntries;
+    }
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return undefined;
+        if (entry.expiresAt < Date.now()) {
+            this.store.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    set(key, value, ttlSeconds) {
+        if (this.store.size >= this.maxEntries) {
+            const oldest = this.store.keys().next().value;
+            if (oldest !== undefined)
+                this.store.delete(oldest);
+        }
+        this.store.set(key, {
+            value,
+            expiresAt: Date.now() + ttlSeconds * 1000,
+        });
+    }
+    async wrap(key, ttlSeconds, fn) {
+        const cached = this.get(key);
+        if (cached !== undefined)
+            return cached;
+        const value = await fn();
+        this.set(key, value, ttlSeconds);
+        return value;
+    }
+    clear() {
+        this.store.clear();
+    }
+    size() {
+        return this.store.size;
+    }
+}
+export const cache = new MemoryCache();
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,WAAW;IACL,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC/C,UAAU,CAAS;IAEpC,YAAY,UAAU,GAAG,IAAI;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,UAAkB;QAC9C,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CACR,GAAW,EACX,UAAkB,EAClB,EAAoB;QAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,EAAE,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/dist/connectors/ban.d.ts

@@ -0,0 +1,15 @@
+import type { Address, Provenance } from "../schemas/canonical.js";
+import { Connector, type ConnectorMetadata } from "./base.js";
+export interface BanResult extends Address {
+    score: number;
+    label: string;
+    type?: string;
+    provenance: Provenance[];
+}
+export declare class BanConnector extends Connector {
+    readonly metadata: ConnectorMetadata;
+    search(query: string, limit?: number): Promise<BanResult[]>;
+    reverse(latitude: number, longitude: number): Promise<BanResult[]>;
+    private normalize;
+}
+//# sourceMappingURL=ban.d.ts.map

package/dist/connectors/ban.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ban.d.ts","sourceRoot":"","sources":["../../src/connectors/ban.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAwB9D,MAAM,WAAW,SAAU,SAAQ,OAAO;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,EAAE,CAAC;CAC1B;AAED,qBAAa,YAAa,SAAQ,SAAS;IACzC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAQlC;IAEI,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAMtD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAMxE,OAAO,CAAC,SAAS;CAsBlB"}

package/dist/connectors/ban.js

@@ -0,0 +1,46 @@
+import { Connector } from "./base.js";
+const BASE_URL = "https://api-adresse.data.gouv.fr";
+export class BanConnector extends Connector {
+    metadata = {
+        id: "ban",
+        name: "Base Adresse Nationale (BAN)",
+        description: "Géocodage et recherche d'adresses françaises (référentiel officiel).",
+        source: "https://adresse.data.gouv.fr",
+        license: "Licence Ouverte 2.0 (Etalab) / ODbL",
+        authRequired: false,
+        defaultTtlSeconds: 86400 * 7,
+    };
+    async search(query, limit = 5) {
+        const url = `${BASE_URL}/search/?q=${encodeURIComponent(query)}&limit=${limit}`;
+        const data = await this.getJson(url);
+        return data.features.map((f) => this.normalize(f, url));
+    }
+    async reverse(latitude, longitude) {
+        const url = `${BASE_URL}/reverse/?lat=${latitude}&lon=${longitude}`;
+        const data = await this.getJson(url);
+        return data.features.map((f) => this.normalize(f, url));
+    }
+    normalize(f, url) {
+        const provenance = {
+            source: this.metadata.id,
+            source_url: url,
+            fetched_at: new Date().toISOString(),
+            license: this.metadata.license,
+        };
+        return {
+            label: f.properties.label,
+            score: f.properties.score,
+            type: f.properties.type,
+            full: f.properties.label,
+            street: [f.properties.housenumber, f.properties.street].filter(Boolean).join(" ") || undefined,
+            postal_code: f.properties.postcode,
+            city: f.properties.city,
+            insee_code: f.properties.citycode,
+            country: "FR",
+            latitude: f.geometry.coordinates[1],
+            longitude: f.geometry.coordinates[0],
+            provenance: [provenance],
+        };
+    }
+}
+//# sourceMappingURL=ban.js.map

package/dist/connectors/ban.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ban.js","sourceRoot":"","sources":["../../src/connectors/ban.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAA0B,MAAM,WAAW,CAAC;AAE9D,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AA6BpD,MAAM,OAAO,YAAa,SAAQ,SAAS;IAChC,QAAQ,GAAsB;QACrC,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,sEAAsE;QACnF,MAAM,EAAE,8BAA8B;QACtC,OAAO,EAAE,qCAAqC;QAC9C,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,KAAK,GAAG,CAAC;KAC7B,CAAC;IAEF,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,KAAK,GAAG,CAAC;QACnC,MAAM,GAAG,GAAG,GAAG,QAAQ,cAAc,kBAAkB,CAAC,KAAK,CAAC,UAAU,KAAK,EAAE,CAAC;QAChF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAiB,GAAG,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,SAAiB;QAC/C,MAAM,GAAG,GAAG,GAAG,QAAQ,iBAAiB,QAAQ,QAAQ,SAAS,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAiB,GAAG,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEO,SAAS,CAAC,CAAa,EAAE,GAAW;QAC1C,MAAM,UAAU,GAAe;YAC7B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;YACxB,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;SAC/B,CAAC;QACF,OAAO;YACL,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK;YACzB,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK;YACzB,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI;YACvB,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK;YACxB,MAAM,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS;YAC9F,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ;YAClC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI;YACvB,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ;YACjC,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;YACnC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;YACpC,UAAU,EAAE,CAAC,UAAU,CAAC;SACzB,CAAC;IACJ,CAAC;CACF"}

package/dist/connectors/base.d.ts

@@ -0,0 +1,18 @@
+export interface ConnectorMetadata {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly source: string;
+    readonly license: string;
+    readonly authRequired: boolean;
+    readonly defaultTtlSeconds: number;
+}
+export declare abstract class Connector {
+    abstract readonly metadata: ConnectorMetadata;
+    protected getJson<T>(url: string, options?: {
+        headers?: Record<string, string>;
+        ttlSeconds?: number;
+        cacheKey?: string;
+    }): Promise<T>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/connectors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/connectors/base.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,8BAAsB,SAAS;IAC7B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;cAE9B,OAAO,CAAC,CAAC,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACd,GACL,OAAO,CAAC,CAAC,CAAC;CAOd"}

package/dist/connectors/base.js

@@ -0,0 +1,10 @@
+import { cache } from "../cache/index.js";
+import { fetchJson } from "../utils/http.js";
+export class Connector {
+    async getJson(url, options = {}) {
+        const ttl = options.ttlSeconds ?? this.metadata.defaultTtlSeconds;
+        const key = options.cacheKey ?? `${this.metadata.id}:${url}`;
+        return cache.wrap(key, ttl, () => fetchJson(url, { headers: options.headers }));
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/connectors/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/connectors/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAY7C,MAAM,OAAgB,SAAS;IAGnB,KAAK,CAAC,OAAO,CACrB,GAAW,EACX,UAII,EAAE;QAEN,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAClE,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC;QAC7D,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAC/B,SAAS,CAAI,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAChD,CAAC;IACJ,CAAC;CACF"}

package/dist/connectors/bodacc.d.ts

@@ -0,0 +1,11 @@
+import type { LegalAnnouncement } from "../schemas/canonical.js";
+import { Connector, type ConnectorMetadata } from "./base.js";
+export declare class BodaccConnector extends Connector {
+    readonly metadata: ConnectorMetadata;
+    searchBySiren(siren: string, limit?: number): Promise<LegalAnnouncement[]>;
+    searchByCompanyName(name: string, limit?: number): Promise<LegalAnnouncement[]>;
+    searchProcedures(siren: string, limit?: number): Promise<LegalAnnouncement[]>;
+    private searchRaw;
+    private normalize;
+}
+//# sourceMappingURL=bodacc.d.ts.map

package/dist/connectors/bodacc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bodacc.d.ts","sourceRoot":"","sources":["../../src/connectors/bodacc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAwB9D,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CASlC;IAEI,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKtE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAK3E,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAKjE,SAAS;IAMvB,OAAO,CAAC,SAAS;CAgBlB"}

package/dist/connectors/bodacc.js

@@ -0,0 +1,47 @@
+import { Connector } from "./base.js";
+const BASE_URL = "https://bodacc-datadila.opendatasoft.com/api/explore/v2.1/catalog/datasets/annonces-commerciales/records";
+export class BodaccConnector extends Connector {
+    metadata = {
+        id: "bodacc",
+        name: "BODACC (Bulletin Officiel des Annonces Civiles et Commerciales)",
+        description: "Annonces légales : créations, ventes, procédures collectives, comptes annuels, modifications.",
+        source: "https://bodacc-datadila.opendatasoft.com",
+        license: "Licence Ouverte 2.0 (Etalab)",
+        authRequired: false,
+        defaultTtlSeconds: 86400,
+    };
+    async searchBySiren(siren, limit = 20) {
+        const where = `registre LIKE "%${siren}%"`;
+        return this.searchRaw(where, limit);
+    }
+    async searchByCompanyName(name, limit = 20) {
+        const where = `commercant LIKE "%${name.replace(/"/g, "")}%"`;
+        return this.searchRaw(where, limit);
+    }
+    async searchProcedures(siren, limit = 20) {
+        const where = `registre LIKE "%${siren}%" AND familleavis_lib LIKE "%procédure%"`;
+        return this.searchRaw(where, limit);
+    }
+    async searchRaw(where, limit) {
+        const url = `${BASE_URL}?where=${encodeURIComponent(where)}&limit=${limit}&order_by=dateparution DESC`;
+        const data = await this.getJson(url);
+        return (data.results ?? []).map((r) => this.normalize(r));
+    }
+    normalize(r) {
+        const sirenMatch = Array.isArray(r.registre)
+            ? r.registre.find((x) => /\d{9}/.test(x))
+            : typeof r.registre === "string"
+                ? r.registre.match(/\d{9}/)?.[0]
+                : undefined;
+        return {
+            id: r.id ?? r.numeroannonce ?? `${r.dateparution}-${r.commercant}`,
+            type: r.familleavis_lib ?? "Annonce",
+            published_at: r.dateparution ?? "",
+            company_siren: sirenMatch?.match(/\d{9}/)?.[0],
+            company_name: r.commercant,
+            content: r.jugement ?? r.listepersonnes,
+            source_url: r.url_complete,
+        };
+    }
+}
+//# sourceMappingURL=bodacc.js.map

package/dist/connectors/bodacc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bodacc.js","sourceRoot":"","sources":["../../src/connectors/bodacc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAA0B,MAAM,WAAW,CAAC;AAE9D,MAAM,QAAQ,GAAG,0GAA0G,CAAC;AAsB5H,MAAM,OAAO,eAAgB,SAAQ,SAAS;IACnC,QAAQ,GAAsB;QACrC,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,iEAAiE;QACvE,WAAW,EACT,+FAA+F;QACjG,MAAM,EAAE,0CAA0C;QAClD,OAAO,EAAE,8BAA8B;QACvC,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,KAAK;KACzB,CAAC;IAEF,KAAK,CAAC,aAAa,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE;QAC3C,MAAM,KAAK,GAAG,mBAAmB,KAAK,IAAI,CAAC;QAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,IAAY,EAAE,KAAK,GAAG,EAAE;QAChD,MAAM,KAAK,GAAG,qBAAqB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;QAC9D,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE;QAC9C,MAAM,KAAK,GAAG,mBAAmB,KAAK,2CAA2C,CAAC;QAClF,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,KAAa;QAClD,MAAM,GAAG,GAAG,GAAG,QAAQ,UAAU,kBAAkB,CAAC,KAAK,CAAC,UAAU,KAAK,6BAA6B,CAAC;QACvG,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAc,GAAG,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAEO,SAAS,CAAC,CAAY;QAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC1C,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;gBAC9B,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;gBAChC,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO;YACL,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,aAAa,IAAI,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,UAAU,EAAE;YAClE,IAAI,EAAE,CAAC,CAAC,eAAe,IAAI,SAAS;YACpC,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,EAAE;YAClC,aAAa,EAAE,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9C,YAAY,EAAE,CAAC,CAAC,UAAU;YAC1B,OAAO,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,cAAc;YACvC,UAAU,EAAE,CAAC,CAAC,YAAY;SAC3B,CAAC;IACJ,CAAC;CACF"}

package/dist/connectors/companies-house.d.ts

@@ -0,0 +1,13 @@
+import type { Company, SearchResult } from "../schemas/canonical.js";
+import { Connector, type ConnectorMetadata } from "./base.js";
+export declare class CompaniesHouseConnector extends Connector {
+    readonly metadata: ConnectorMetadata;
+    private get authHeader();
+    search(query: string, itemsPerPage?: number): Promise<SearchResult>;
+    getByNumber(companyNumber: string): Promise<Company | null>;
+    private normalizeSummary;
+    private normalizeProfile;
+    private normalizeAddress;
+    private makeProvenance;
+}
+//# sourceMappingURL=companies-house.d.ts.map

package/dist/connectors/companies-house.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companies-house.d.ts","sourceRoot":"","sources":["../../src/connectors/companies-house.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,OAAO,EAAuB,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEnG,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AA8D9D,qBAAa,uBAAwB,SAAQ,SAAS;IACpD,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CASlC;IAEF,OAAO,KAAK,UAAU,GAIrB;IAEK,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,SAAK,GAAG,OAAO,CAAC,YAAY,CAAC;IAc/D,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAYjE,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,gBAAgB;IAkCxB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,cAAc;CAQvB"}

package/dist/connectors/companies-house.js

@@ -0,0 +1,104 @@
+import { requireEnv } from "../utils/oauth.js";
+import { Connector } from "./base.js";
+const BASE_URL = "https://api.company-information.service.gov.uk";
+export class CompaniesHouseConnector extends Connector {
+    metadata = {
+        id: "companies-house-uk",
+        name: "Companies House UK",
+        description: "Registre officiel des sociétés britanniques (Companies House). Recherche et fiche par numéro Companies House. Couvre England, Wales, Scotland, Northern Ireland.",
+        source: "https://developer.company-information.service.gov.uk",
+        license: "Open Government Licence v3.0",
+        authRequired: true,
+        defaultTtlSeconds: 86400,
+    };
+    get authHeader() {
+        const key = requireEnv("COMPANIES_HOUSE_API_KEY");
+        const credentials = Buffer.from(`${key}:`).toString("base64");
+        return { Authorization: `Basic ${credentials}` };
+    }
+    async search(query, itemsPerPage = 10) {
+        const url = `${BASE_URL}/search/companies?q=${encodeURIComponent(query)}&items_per_page=${itemsPerPage}`;
+        const data = await this.getJson(url, { headers: this.authHeader });
+        return {
+            query,
+            total: data.total_results ?? 0,
+            page: data.page_number ?? 1,
+            per_page: data.items_per_page ?? itemsPerPage,
+            results: (data.items ?? []).map((item) => this.normalizeSummary(item)),
+            provenance: [this.makeProvenance(url)],
+        };
+    }
+    async getByNumber(companyNumber) {
+        const profileUrl = `${BASE_URL}/company/${companyNumber}`;
+        const officersUrl = `${BASE_URL}/company/${companyNumber}/officers`;
+        const [profile, officersData] = await Promise.all([
+            this.getJson(profileUrl, { headers: this.authHeader }),
+            this.getJson(officersUrl, { headers: this.authHeader }).catch(() => null),
+        ]);
+        return this.normalizeProfile(profile, officersData);
+    }
+    normalizeSummary(item) {
+        return {
+            siren: item.company_number,
+            legal_name: item.title,
+            active: item.company_status === "active",
+            created_at: item.date_of_creation,
+            closed_at: item.date_of_cessation,
+            naf_code: item.sic_codes?.[0],
+            registered_address: item.registered_office_address
+                ? this.normalizeAddress(item.registered_office_address)
+                : undefined,
+            provenance: [this.makeProvenance(`${BASE_URL}/company/${item.company_number}`)],
+            _raw: item,
+        };
+    }
+    normalizeProfile(profile, officersData) {
+        const officers = (officersData?.items ?? [])
+            .filter((o) => !o.resigned_on)
+            .map((o) => {
+            const dob = o.date_of_birth;
+            const birth_date_partial = dob?.year && dob?.month
+                ? `${dob.year}-${String(dob.month).padStart(2, "0")}`
+                : undefined;
+            return {
+                name: o.name ?? "Unknown",
+                role: o.officer_role,
+                type: "person",
+                birth_date_partial,
+                nationality: o.nationality,
+            };
+        });
+        const url = `${BASE_URL}/company/${profile.company_number}`;
+        return {
+            siren: profile.company_number,
+            legal_name: profile.company_name,
+            active: profile.company_status === "active",
+            created_at: profile.date_of_creation,
+            closed_at: profile.date_of_cessation,
+            naf_code: profile.sic_codes?.[0],
+            registered_address: profile.registered_office_address
+                ? this.normalizeAddress(profile.registered_office_address)
+                : undefined,
+            officers,
+            provenance: [this.makeProvenance(url)],
+            _raw: profile,
+        };
+    }
+    normalizeAddress(addr) {
+        return {
+            street: [addr.address_line_1, addr.address_line_2].filter(Boolean).join(", ") || undefined,
+            city: addr.locality,
+            postal_code: addr.postal_code,
+            country: addr.country ?? "GB",
+        };
+    }
+    makeProvenance(url) {
+        return {
+            source: this.metadata.id,
+            source_url: url,
+            fetched_at: new Date().toISOString(),
+            license: this.metadata.license,
+        };
+    }
+}
+//# sourceMappingURL=companies-house.js.map

package/dist/connectors/companies-house.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"companies-house.js","sourceRoot":"","sources":["../../src/connectors/companies-house.ts"],"names":[],"mappings":"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"}

package/dist/connectors/dvf.d.ts

@@ -0,0 +1,13 @@
+import type { RealEstateTransaction } from "../schemas/canonical.js";
+import { Connector, type ConnectorMetadata } from "./base.js";
+export declare class DvfConnector extends Connector {
+    readonly metadata: ConnectorMetadata;
+    /**
+     * Recherche les mutations sur une commune (code INSEE).
+     * Endpoint stable alternatif via api.cquest.org/dvf si CEREMA indisponible.
+     */
+    searchByCommune(codeInsee: string, limit?: number): Promise<RealEstateTransaction[]>;
+    searchByPostalCode(postalCode: string, limit?: number): Promise<RealEstateTransaction[]>;
+    private normalize;
+}
+//# sourceMappingURL=dvf.d.ts.map

package/dist/connectors/dvf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dvf.d.ts","sourceRoot":"","sources":["../../src/connectors/dvf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AA2B9D,qBAAa,YAAa,SAAQ,SAAS;IACzC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAQlC;IAEF;;;OAGG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAMhF,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAM1F,OAAO,CAAC,SAAS;CAuBlB"}

package/dist/connectors/dvf.js

@@ -0,0 +1,51 @@
+import { Connector } from "./base.js";
+const BASE_URL = "https://apidf-preprod.cerema.fr/dvf_opendata/mutations";
+export class DvfConnector extends Connector {
+    metadata = {
+        id: "dvf",
+        name: "DVF (Demandes de Valeurs Foncières)",
+        description: "Transactions immobilières en France sur les 5 dernières années.",
+        source: "https://app.dvf.etalab.gouv.fr",
+        license: "Licence Ouverte 2.0 (Etalab)",
+        authRequired: false,
+        defaultTtlSeconds: 86400 * 30,
+    };
+    /**
+     * Recherche les mutations sur une commune (code INSEE).
+     * Endpoint stable alternatif via api.cquest.org/dvf si CEREMA indisponible.
+     */
+    async searchByCommune(codeInsee, limit = 50) {
+        const url = `https://api.cquest.org/dvf?code_commune=${encodeURIComponent(codeInsee)}`;
+        const data = await this.getJson(url);
+        return (data.resultats ?? []).slice(0, limit).map((r) => this.normalize(r));
+    }
+    async searchByPostalCode(postalCode, limit = 50) {
+        const url = `https://api.cquest.org/dvf?code_postal=${encodeURIComponent(postalCode)}`;
+        const data = await this.getJson(url);
+        return (data.resultats ?? []).slice(0, limit).map((r) => this.normalize(r));
+    }
+    normalize(r) {
+        const address = {
+            street: [r.adresse_numero, r.adresse_suffixe, r.adresse_nom_voie]
+                .filter(Boolean)
+                .join(" ") || undefined,
+            postal_code: r.code_postal,
+            city: r.nom_commune,
+            insee_code: r.code_commune,
+            latitude: r.latitude,
+            longitude: r.longitude,
+            country: "FR",
+        };
+        return {
+            date: r.date_mutation,
+            type: r.nature_mutation,
+            price_eur: r.valeur_fonciere,
+            surface_built_m2: r.surface_reelle_bati,
+            surface_land_m2: r.surface_terrain,
+            rooms: r.nombre_pieces_principales,
+            property_type: r.type_local,
+            address,
+        };
+    }
+}
+//# sourceMappingURL=dvf.js.map