langchain-eu-nordic-open-data

LangChain tools for official EU and Finnish open data, backed by the hosted itulo/* Apify actors from eu-nordic-open-data-mcp. No Node.js, scraping or site search: every tool calls an official public API and every record keeps the upstream licence and attribution fields.

Install

pip install langchain-eu-nordic-open-data
export APIFY_TOKEN=...        # https://console.apify.com/settings/integrations
export FINGRID_API_KEY=...    # optional, free from https://data.fingrid.fi

The actors are pay-per-event; runs are billed to the Apify account of your token.

Use

from langchain_eu_nordic_open_data import TedTenderSearchTool, get_tools

ted = TedTenderSearchTool()
notices = ted.invoke({"cpvCodes": ["72000000"], "countries": ["FI"], "maxResults": 5})
for n in notices:
    print(n["publicationNumber"], n["title"][:80])
print(notices[0]["attribution"])   # keep the attribution when you display results

With an agent (any chat model integration):

from langchain.agents import create_agent
from langchain_eu_nordic_open_data import get_tools

agent = create_agent(
    model="openai:gpt-4.1-mini",
    tools=get_tools(),   # Fingrid tool is added when FINGRID_API_KEY is set
    system_prompt="Use the tools for EU/Finnish official data and quote each result's attribution.",
)
agent.invoke({"messages": [{"role": "user", "content": "Open IT tenders from Estonian buyers this week?"}]})

Prefer MCP? The same data is available as a local stdio MCP server (npx eu-nordic-open-data-mcp) usable with langchain-mcp-adapters; see the repo examples.

Data licences and attribution

Data comes from official publishers under their reuse terms (Commission Decision 2011/833/EU for TED, VIES and the sanctions list; ECB reuse policy; CC BY 4.0 for PRH, FMI, Fingrid and Digitraffic). Each record includes the attribution text and licence URL; keep them when you republish. Full register: LICENCE_REGISTER.md.

This package is independent and not affiliated with or endorsed by any of these publishers. Sanctions screening results are an aid, not legal advice. No personal data is collected; sole-trader personal data is filtered out by the actors. No Nord Pool or exchange price data.

Development

pip install -e ".[test]" && pytest
python -m build && twine check dist/*

Licence: MIT.