{
  "markdown": "# NorthData Connectors\n\n> Generic, product-side wrapper around the [NorthData](https://www.northdata.com) API — a Python CLI, an MCP server, and a Claude Skill, sharing one credit guard.\n\n[![PyPI — northdata-cli](https://img.shields.io/pypi/v/northdata-cli?label=northdata-cli)](https://pypi.org/project/northdata-cli/)\n[![PyPI — northdata-mcp](https://img.shields.io/pypi/v/northdata-mcp?label=northdata-mcp)](https://pypi.org/project/northdata-mcp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n> **Unofficial project.** This repository is an independent, community-maintained wrapper around the NorthData API. It is **not developed, endorsed, or supported by NorthData GmbH**. \"NorthData\" is a trademark of its respective owner; all company data accessed through this tooling remains subject to [NorthData's own terms of service](https://www.northdata.de/_agb). For the official API documentation, see [github.com/northdata/api](https://github.com/northdata/api).\n\nThis monorepo ships three layers on top of the NorthData API:\n\n| Package | What it is | Install |\n|---|---|---|\n| [`northdata-cli`](./northdata-cli) | Command-line client. JSON-by-default, table with `--pretty`. Single source of API logic. | `pipx install northdata-cli` |\n| [`northdata-mcp`](./northdata-mcp) | [Model Context Protocol](https://modelcontextprotocol.io) server exposing every CLI command as a tool. Works with Claude Desktop, Claude Code, Cursor, etc. | `pipx install northdata-mcp` |\n| [`skills/northdata`](./skills/northdata) | Claude Skill with usage guidance, credit-guard discipline, and endpoint cheat-sheet. | `npx skills add p-meier/northdata-connectors` |\n\nAll three share **one credit guard** because NorthData charges per returned company, not per HTTP call.\n\n---\n\n## Why this exists\n\nNorthData's API is the canonical source for German commercial-register data (company profiles, owners, representatives, financials, publications). This repo makes it trivial to consume that data from:\n\n- Shell scripts and CI pipelines (`northdata search ...`)\n- AI agents in any MCP-capable client (Claude Desktop, Cursor, Claude Code, …)\n- Claude Skills that want domain-aware guidance without duplicating API code\n\nThe three layers never duplicate logic — the CLI is the library, the MCP server imports it, the Skill references the MCP tools.\n\n---\n\n## Quick start\n\n### 1. Get a NorthData API key\n\nAt <https://www.northdata.com>. Set it as `NORTHDATA_API_KEY`.\n\n### 2. Install what you need\n\n```bash\n# Shell usage\npipx install northdata-cli\nexport NORTHDATA_API_KEY=XXXX-XXXX\nnorthdata suggest \"Siemens\" --pretty\n\n# MCP server for Claude Desktop / Cursor / Claude Code\npipx install northdata-mcp\n# then add the stdio server to your MCP client config\n# (see northdata-mcp/README.md)\n\n# Claude Skill — usage guidance for agents\nnpx skills add p-meier/northdata-connectors\n```\n\n### 3. Credit-safe by default\n\nEvery billable call respects two tiers:\n\n| Tier | Default | Env var |\n|---|---|---|\n| Approval threshold | `25` | `NORTHDATA_APPROVAL_THRESHOLD` |\n| Absolute maximum | `100` | `NORTHDATA_ABSOLUTE_MAX` |\n\nUse `--dry-run` (CLI) or `dry_run=true` (MCP) to inspect a request without spending credits.\n\n---\n\n## Architecture\n\n```\n                      ┌─────────────────────────────────────────┐\n                      │         NorthData API (HTTP)            │\n                      └─────────────────────────────────────────┘\n                                        ▲\n                                        │ httpx + Credit Guard\n                                        │\n                            ┌───────────────────────┐\n                            │   northdata-cli       │  ← single source of API logic\n                            │   (Python library)    │     (client, credit guard,\n                            └───────────────────────┘      config, output)\n                                ▲               ▲\n                    imports     │               │  invokes\n                                │               │\n              ┌───────────────────────┐   ┌───────────────────────┐\n              │   northdata-mcp       │   │   shell / CI /        │\n              │   (FastMCP, stdio)    │   │   scripts             │\n              └───────────────────────┘   └───────────────────────┘\n                        ▲\n                        │ MCP over stdio\n                        │\n              ┌───────────────────────┐\n              │   Claude / Cursor /   │   ← with skills/northdata/SKILL.md\n              │   any MCP client      │     loaded for usage guidance\n              └───────────────────────┘\n```\n\nThe CLI holds the API logic; the MCP server is a thin wrapper; the Skill is documentation-as-code. All three share one credit guard.\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/p-meier/northdata-connectors.git\ncd northdata-connectors\n\n# CLI\ncd northdata-cli && python -m venv .venv && source .venv/bin/activate\npip install -e \".[dev]\" && pytest\n\n# MCP\ncd ../northdata-mcp && python -m venv .venv && source .venv/bin/activate\npip install -e \"../northdata-cli\" -e \".[dev]\" && pytest\n```\n\n---\n\n## License\n\nMIT. See [LICENSE](northdata-cli/LICENSE).\n\n---\n\n## Links\n\n- **NorthData API docs:** <https://github.com/northdata/api>\n- **Model Context Protocol:** <https://modelcontextprotocol.io>\n- **Claude Skills (skills.sh):** <https://skills.sh>\n",
  "bytes": 5395,
  "sha": "b8b402de90cde3d96b0b0fefdfa453aa64be0cbfb91eeacdda4ee17e5a1bbbb5",
  "repo_slug": "p-meier/northdata-connectors",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_p_meier_northdata_mcp_0895e8e0/readme"
}