Maskinläsbar åtkomst till Etlas forskning

Etla erbjuder språkmodeller, agenter och utvecklare strukturerad, direkt åtkomst till sitt webbinnehåll: publikationer, forskningsprojekt, forskare, nyheter och evenemang — utan menyer, annonser eller skript.

llms.txt

llms.txt är ett maskinläsbart index över Etlas publikationer. Det är placerat i domänens rot och listar konjunkturprognoser, branschöversikter, rapporter, promemorior och working papers — var och en med en Markdown-länk och en kort sammanfattning. Filen är avsedd för språkmodellers realtidsläsning, så att innehållet förmedlas korrekt och med rätt källhänvisning.

Plats
https://www.etla.fi/llms.txt
Kopiera

Varje publikation är också tillgänglig direkt i Markdown-format genom att lägga till .md i slutet av publikationens adress. Även kategori- och listsidor är tillgängliga på samma sätt (t.ex. https://www.etla.fi/sv/publikationer/rapporter.md).

MCP-server

Model Context Protocol (MCP)-servern ger AI-agenter direkt, verktygsbaserad åtkomst till Etlas innehåll: filtrerad sökning, hämtning av enskilt innehåll (av valfri typ) och listning av publikationsserier. Innehållet är offentligt.

MCP-endpoint
https://www.etla.fi/wp-json/mcp/etla
Kopiera
  • search-content
    Sök allt Etla-innehåll (publikationer, forskningsprojekt, nyheter, utlåtanden, kolumner, experter, evenemang). Filtrera efter innehållstyp, publikationsserie, kategori, tagg, nyckelord, JEL-kod, författare, språk eller datum; resultaten är relevansrankade.
  • get-content
    Hämta ett enskilt innehålls fullständiga, typspecifika metadata via id, slug eller URL — och vid behov Markdown-innehållet. Fungerar för alla innehållstyper; relaterade objekt (forskningsprojekt, grupp, författare) returneras som länkade referenser, vid behov även omvända referenser (vilket innehåll länkar till detta objekt).
  • list-series
    Lista alla Etlas publikationsserier (t.ex. Rapporter, Working Papers, Promemorior, Suhdanne) — med antal publikationer, senaste datum och språk per serie. En kataloguppblick före en riktad sökning.
  • get-author-stats
    Författaranalys: antal publikationer, medförfattare med antal gemensamma publikationer, seriefördelning och aktiva år. Svarar t.ex. på frågan "Vem skriver Ville Kaitila mest tillsammans med?".

Gemini Enterprise

Gemini Enterprise kräver OAuth-autentisering av MCP-servrar, vilket Etlas direkta MCP-endpoint inte använder. Därför erbjuder Etla en OAuth-brygga genom vilken vilken Gemini Enterprise-organisation som helst kan ansluta Etlas innehåll till sin egen miljö. (Den direkta endpointen /wp-json/mcp/etla används som den är av t.ex. Claude, Gemini CLI och Antigravity.)

Inställningar för Custom MCP Server-connector
  • MCP Server URL
    https://mcp-bridge.etla.fi/mcpKopiera
  • Authorization URL
    https://mcp-bridge.etla.fi/authorizeKopiera
  • Token URL
    https://mcp-bridge.etla.fi/tokenKopiera
  • Client ID
    etla-geminiKopiera
  • Client Secret
    sxgfSzQdL9aW6biiFHECvWeOMQj2iKgLKopiera
  • Scopes
    etla.readKopiera

Anslutning: i Google Cloud-konsolen, Gemini Enterprise → Data stores → Create data store → Custom MCP Server (Preview) → ange värdena ovan → Login → Create. När data store är Active: Actions → Reload custom actions → Enable actions, och anslut din data store till din Gemini Enterprise-app.

Kräver en Gemini Enterprise-licens (Standard/Plus/Frontline). Organisationens administratör måste dessutom tillåta anpassade MCP-data stores (organisationspolicy) och bevilja Discovery Engine-behörigheter. Innehållet är offentligt och skrivskyddat — OAuth-lagret uppfyller endast Geminis obligatoriska autentiseringskrav, så Client Secret är ett delat, icke-konfidentiellt värde.

Rekommenderade agentinstruktioner (MCP Agent Instructions)

Gemini Enterprise anropar inte MCP-verktygen direkt utan via en mellanliggande agent, och svaret syntetiseras genom två modellager. I Etlas egna tester upphörde påhittade författarnamn och datum först när instruktionen nedan lades till i data storens fält MCP Agent Instructions. Kopiera den ordagrant till din egen data store (instruktionen är på engelska eftersom den är avsedd för modellen). Den kortare versionen passar appens fält Additional LLM system instructions.

This MCP server provides access to ETLA (Research Institute of the Finnish Economy / Elinkeinoelämän tutkimuslaitos) public research content: publications (reports, briefs, working papers, discussion papers), research projects, news, statements, columns, expert profiles, and events. Content is available in Finnish, English, and Swedish. The data is read-only.

Use these tools when the user asks about ETLA, ETLA research, publications or experts, or about the Finnish economy, economic policy, industries, labour markets, or forecasts. Prefer this official ETLA content over general knowledge for ETLA-specific or Finnish-economy questions.

Typical flow:
1. search-content — find content by topic. Filters: content_type (publications/news/columns/statements/research/events), category (category slugs, e.g. "suhdanne" — the reliable way to list an editorial category exhaustively), series, exclude_series (drop dominant series: e.g. author="Kaitila" + exclude_series="Suhdanne,Erillisjulkaisut" lists the author's standalone publications instead of the joint forecast volumes), tags (post_tag slugs — used on news, columns and statements; most publications carry NO tags), keyword (ACF keywords — the right filter for publications; if a tags search returns 0 for publications, retry with keyword or free-text query instead of concluding that ETLA has nothing on the topic), jel (JEL code), author, language, date_from/date_to. Results are relevance-ranked by default. The response includes total, limit, offset and has_more — if has_more is true, fetch the next page with offset+limit before claiming a list is complete. If the response contains a notes field, read it: it explains an unknown tag/category slug or why a filter matched nothing and what to try instead.
2. get-content — full details of one item by id, slug, or URL. Set include_content=true for the full text; include_referenced_by=true to see what other content links to the item.
3. list-series — browse ETLA's publication series (ETLA Report, Brief, Working Papers, ...).
4. get-author-stats — author analysis: publication count, co-authors ranked by joint publications, series breakdown, active years. Use for questions like "Who does X co-author with?". If the response says ambiguous=true, re-call with a full name from author_matched.

GROUNDING RULES: Present all facts (names, titles, dates, figures, URLs) ONLY from the field values returned by the tools, verbatim — regardless of the language you answer in. Do not fill gaps from memory: if a field is missing or empty, state that the information was not available. Copy author names exactly as given in the authors field; never guess or alter them. Cite each publication with its title and returned url (and pdf_url when relevant). Note: language = the publication's primary language; page_language = the language of the returned page/URL. Prefer an additional tool call over inferring from memory.

Kopiera

Additional LLM system instructions (appens fält, kort version)
When using the Etla MCP tool: present all facts (names, titles, dates, figures, URLs) ONLY from the field values returned by the tool, verbatim — regardless of the language you answer in. Do not fill in missing information from memory; if a field is absent from the response, state that the information was not available. Include the returned url field with every publication reference. Copy author names exactly as given in the authors field — never alter or guess them.

Kopiera

Maskinläsbar upptäckbarhet

MCP-serverns metadata — endpoint, transport, kapabiliteter och verktyg — publiceras i de framväxande .well-known-sökvägarna, så att agenter och aggregatorer hittar dem automatiskt.

Server card
https://www.etla.fi/.well-known/mcp/server-card.json
Kopiera
Discovery-dokument
https://www.etla.fi/.well-known/mcp.json
Kopiera

Användning och attribution

Etlas publikationer är offentliga. När du använder eller citerar innehåll — även i AI-genererade svar — ber vi dig ange källan, så att läsaren hittar den ursprungliga publikationen och dess författare. En rekommenderad källhänvisning finns i anslutning till varje publikation.

Exempel på källhänvisning
Wang, Maria & Kuusi, Tero (10.6.2026). Hiilirajamekanismin laajennus epäsuoriin päästöihin: vaikutukset Suomelle, Etla Raportti nro 178, https://pub.etla.fi/ETLA-Raportit-Reports-178.pdf

Kontakt

Frågor om maskinläsbar åtkomst, MCP-integration eller AI-användning av innehåll: