factline 0.1.0__tar.gz

factline-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Factline
+
+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.

factline-0.1.0/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: factline
+Version: 0.1.0
+Summary: Client for Factline: sanctions, PEP, KYC and company checks, plus Dutch address, rent and vehicle data, for apps and AI agents.
+Author-email: Factline <hello@factline.dev>
+License-Expression: MIT
+Project-URL: Homepage, https://factline.dev/agents
+Project-URL: Documentation, https://factline.dev/docs
+Keywords: sanctions,pep,kyc,kyb,aml,netherlands,rdw,mcp,ai-agents,x402
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# factline
+
+Official-records checks for apps and AI agents: sanctions and PEP screening, one-call KYC, company registers in 10 countries, Dutch insolvency, EU VAT, EORI, IBAN, email and phone checks, plus Dutch address, neighbourhood, rent, flood, school and vehicle data. Standard library only.
+
+```bash
+pip install factline
+```
+
+```python
+from factline import Factline
+
+fl = Factline(api_key="fl_live_...")  # or set FACTLINE_API_KEY
+
+fl.sanctions_screen(name="Acme Trading Ltd")
+fl.kyc_check(name="Jan Jansen", email="jan@example.nl", phone="+31612345678")
+fl.company_lookup(name="Tesco", country="GB")
+fl.rent_check(postcode="2517AS", house_number=100)
+fl.vehicle_basic(licence_plate="GT-722-F")  # free, no key needed
+```
+
+- **API key:** free trial, EUR 19 credit pack or monthly plans at https://factline.dev/business. Without a key, paid calls raise `FactlinePaymentRequired` (the API answers with an x402 payment request that agents with a wallet can pay).
+- **Free preview:** `fl.preview("sanctions_screen", name="Acme")`.
+- **Agents (MCP):** `MCP_SERVERS["kyc"]`, `["nl"]`, `["vehicles"]`. With LangChain: `MultiServerMCPClient({"factline": {"url": MCP_SERVERS["kyc"], "transport": "streamable_http"}})`. More setups: https://factline.dev/agents
+
+MIT licence. Data comes from official sources; see https://factline.dev/trust.

factline-0.1.0/README.md

@@ -0,0 +1,25 @@
+# factline
+
+Official-records checks for apps and AI agents: sanctions and PEP screening, one-call KYC, company registers in 10 countries, Dutch insolvency, EU VAT, EORI, IBAN, email and phone checks, plus Dutch address, neighbourhood, rent, flood, school and vehicle data. Standard library only.
+
+```bash
+pip install factline
+```
+
+```python
+from factline import Factline
+
+fl = Factline(api_key="fl_live_...")  # or set FACTLINE_API_KEY
+
+fl.sanctions_screen(name="Acme Trading Ltd")
+fl.kyc_check(name="Jan Jansen", email="jan@example.nl", phone="+31612345678")
+fl.company_lookup(name="Tesco", country="GB")
+fl.rent_check(postcode="2517AS", house_number=100)
+fl.vehicle_basic(licence_plate="GT-722-F")  # free, no key needed
+```
+
+- **API key:** free trial, EUR 19 credit pack or monthly plans at https://factline.dev/business. Without a key, paid calls raise `FactlinePaymentRequired` (the API answers with an x402 payment request that agents with a wallet can pay).
+- **Free preview:** `fl.preview("sanctions_screen", name="Acme")`.
+- **Agents (MCP):** `MCP_SERVERS["kyc"]`, `["nl"]`, `["vehicles"]`. With LangChain: `MultiServerMCPClient({"factline": {"url": MCP_SERVERS["kyc"], "transport": "streamable_http"}})`. More setups: https://factline.dev/agents
+
+MIT licence. Data comes from official sources; see https://factline.dev/trust.

factline-0.1.0/factline/__init__.py

@@ -0,0 +1,122 @@
+"""Factline client: official-records checks for apps and AI agents (https://factline.dev/agents).
+
+Generated from https://factline.dev/openapi.json. Standard library only.
+"""
+from __future__ import annotations
+
+import json
+import os
+import urllib.error
+import urllib.parse
+import urllib.request
+from typing import Any
+
+__version__ = "0.1.0"
+
+MCP_SERVERS = {
+    "kyc": "https://factline.dev/mcp/kyc",
+    "nl": "https://factline.dev/mcp/nl",
+    "vehicles": "https://factline.dev/mcp/vehicles",
+    "all": "https://factline.dev/mcp",
+    "chat": "https://factline.dev/mcp/chat",
+}
+
+METHODS: dict[str, tuple[str, tuple[str, ...]]] = {
+    "home_basic": ("/v1/home/basic", ()),
+    "vehicle_basic": ("/v1/vehicle/basic", ("licence_plate",)),
+    "schools": ("/v1/schools", ("postcode",)),
+    "vehicle_model": ("/v1/vehicle/model", ("make", "model",)),
+    "home_report": ("/v1/home/report", ()),
+    "home_compare": ("/v1/home/compare", ("addresses",)),
+    "neighbourhood": ("/v1/neighbourhood", ()),
+    "address_lookup": ("/v1/address/lookup", ()),
+    "address_reverse": ("/v1/address/reverse", ("lat", "lon",)),
+    "energy_label": ("/v1/energy-label", ()),
+    "crime": ("/v1/crime", ()),
+    "house_prices": ("/v1/house-prices", ()),
+    "email_verify": ("/v1/email/verify", ("email",)),
+    "phone_verify": ("/v1/phone/verify", ("phone",)),
+    "kyc_check": ("/v1/kyc/check", ()),
+    "eu_vat": ("/v1/eu/vat", ("vat",)),
+    "sanctions_screen": ("/v1/sanctions/screen", ("name",)),
+    "company_lookup": ("/v1/company/lookup", ()),
+    "vehicle_compare": ("/v1/vehicle/compare", ("plates",)),
+    "vehicle_apk": ("/v1/vehicle/apk", ("licence_plate",)),
+    "postcode_addresses": ("/v1/postcode/addresses", ("postcode",)),
+    "sanctions_wallet": ("/v1/sanctions/wallet", ("address",)),
+    "sanctions_batch": ("/v1/sanctions/batch", ("names",)),
+    "batch_addresses": ("/v1/batch/addresses", ("addresses",)),
+    "flood_risk": ("/v1/flood-risk", ()),
+    "eu_tenders": ("/v1/eu/tenders", ("country",)),
+    "nl_insolvency": ("/v1/nl/insolvency", ()),
+    "pep_screen": ("/v1/pep/screen", ("name",)),
+    "pep_batch": ("/v1/pep/batch", ("names",)),
+    "domain_check": ("/v1/domain/check", ("domain",)),
+    "iban_check": ("/v1/iban/check", ("iban",)),
+    "eu_eori": ("/v1/eu/eori", ("eori",)),
+    "rent_check": ("/v1/rent-check", ()),
+    "vehicle_report": ("/v1/vehicle/report", ("licence_plate",)),
+}
+
+
+class FactlineError(Exception):
+    def __init__(self, status: int, body: Any):
+        self.status = status
+        self.body = body
+        super().__init__((body or {}).get("message") if isinstance(body, dict) else f"Factline returned HTTP {status}")
+
+
+class FactlinePaymentRequired(FactlineError):
+    """A paid endpoint was called without an API key (HTTP 402, x402 payment request)."""
+
+    @property
+    def preview(self) -> str | None:
+        return self.body.get("preview") if isinstance(self.body, dict) else None
+
+
+class Factline:
+    def __init__(self, api_key: str | None = None, base_url: str = "https://factline.dev", timeout: float = 30):
+        self.api_key = api_key or os.environ.get("FACTLINE_API_KEY")
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+    def call(self, path: str, **params: Any) -> Any:
+        """Calls any endpoint, e.g. call("/v1/sanctions/screen", name="Acme")."""
+        query = urllib.parse.urlencode({k: v for k, v in params.items() if v is not None})
+        req = urllib.request.Request(f"{self.base_url}{path}{'?' + query if query else ''}", headers={"accept": "application/json", "user-agent": f"factline-python/{__version__}"})
+        if self.api_key:
+            req.add_header("x-api-key", self.api_key)
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as r:
+                return json.load(r)
+        except urllib.error.HTTPError as e:
+            try:
+                body = json.load(e)
+            except Exception:  # noqa: BLE001
+                body = None
+            if e.code == 402:
+                raise FactlinePaymentRequired(402, body) from None
+            raise FactlineError(e.code, body) from None
+
+    def preview(self, method: str, **params: Any) -> Any:
+        """Free preview of a paid check: validates the input and shows what the answer contains."""
+        path, _ = METHODS[method]
+        return self.call(path + "/preview", **params)
+
+
+def _make(name: str, path: str, required: tuple[str, ...]):
+    def method(self: Factline, **params: Any) -> Any:
+        missing = [r for r in required if params.get(r) is None]
+        if missing:
+            raise TypeError(f"{name}: missing {', '.join(missing)}")
+        return self.call(path, **params)
+
+    method.__name__ = name
+    method.__doc__ = f"GET {path}"
+    return method
+
+
+for _name, (_path, _req) in METHODS.items():
+    setattr(Factline, _name, _make(_name, _path, _req))
+
+__all__ = ["Factline", "FactlineError", "FactlinePaymentRequired", "MCP_SERVERS", "METHODS"]

factline-0.1.0/factline.egg-info/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: factline
+Version: 0.1.0
+Summary: Client for Factline: sanctions, PEP, KYC and company checks, plus Dutch address, rent and vehicle data, for apps and AI agents.
+Author-email: Factline <hello@factline.dev>
+License-Expression: MIT
+Project-URL: Homepage, https://factline.dev/agents
+Project-URL: Documentation, https://factline.dev/docs
+Keywords: sanctions,pep,kyc,kyb,aml,netherlands,rdw,mcp,ai-agents,x402
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# factline
+
+Official-records checks for apps and AI agents: sanctions and PEP screening, one-call KYC, company registers in 10 countries, Dutch insolvency, EU VAT, EORI, IBAN, email and phone checks, plus Dutch address, neighbourhood, rent, flood, school and vehicle data. Standard library only.
+
+```bash
+pip install factline
+```
+
+```python
+from factline import Factline
+
+fl = Factline(api_key="fl_live_...")  # or set FACTLINE_API_KEY
+
+fl.sanctions_screen(name="Acme Trading Ltd")
+fl.kyc_check(name="Jan Jansen", email="jan@example.nl", phone="+31612345678")
+fl.company_lookup(name="Tesco", country="GB")
+fl.rent_check(postcode="2517AS", house_number=100)
+fl.vehicle_basic(licence_plate="GT-722-F")  # free, no key needed
+```
+
+- **API key:** free trial, EUR 19 credit pack or monthly plans at https://factline.dev/business. Without a key, paid calls raise `FactlinePaymentRequired` (the API answers with an x402 payment request that agents with a wallet can pay).
+- **Free preview:** `fl.preview("sanctions_screen", name="Acme")`.
+- **Agents (MCP):** `MCP_SERVERS["kyc"]`, `["nl"]`, `["vehicles"]`. With LangChain: `MultiServerMCPClient({"factline": {"url": MCP_SERVERS["kyc"], "transport": "streamable_http"}})`. More setups: https://factline.dev/agents
+
+MIT licence. Data comes from official sources; see https://factline.dev/trust.

factline-0.1.0/factline.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+factline/__init__.py
+factline.egg-info/PKG-INFO
+factline.egg-info/SOURCES.txt
+factline.egg-info/dependency_links.txt
+factline.egg-info/top_level.txt

factline-0.1.0/factline.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

factline-0.1.0/factline.egg-info/top_level.txt

@@ -0,0 +1 @@
+factline

factline-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "factline"
+version = "0.1.0"
+description = "Client for Factline: sanctions, PEP, KYC and company checks, plus Dutch address, rent and vehicle data, for apps and AI agents."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [{ name = "Factline", email = "hello@factline.dev" }]
+keywords = ["sanctions", "pep", "kyc", "kyb", "aml", "netherlands", "rdw", "mcp", "ai-agents", "x402"]
+
+[project.urls]
+Homepage = "https://factline.dev/agents"
+Documentation = "https://factline.dev/docs"
+
+[tool.setuptools]
+packages = ["factline"]

factline-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+