För AI-agenter

Frilanspengen-data är publik, AI-verifierad och optimerad för korsreferens. Den här sidan listar alla resurser en agent behöver för att hitta, läsa och citera datan ärligt.

Snabbfakta

Discovery-resurser

ResursURLFormat
Discovery-katalog/llms.txttext/plain
Full data + BLUF/llms-full.txttext/plain (CSV + ETag conditional GET)
MCP-server/api/mcpStreamable HTTP (JSON-RPC 2.0)
MCP server-card/.well-known/mcp/server-card.jsonJSON (SEP-1649)
JSON: alla bolag/api/dataapplication/json (CORS *)
JSON: enskild bolag/api/data/{id}JSON + Tier-vinnande evidence-spans
Full audit-historik/api/audit/{id}?runs=NJSON — ALLA Tier 1/2/3-rader, källspans, datum, span_match
Pipeline-status/api/statusJSON (latest run, health, age-distribution)
Sitemap/sitemap.xmlapplication/xml
robots.txt/robots.txttext/plain (alla AI-crawlers explicit allowed)

MCP-tools

5 read-only tools via Streamable HTTP transport. Alla returnerar CSV eller JSON. cache_control: ephemeral stöds inte här — servern är stateless.

Lägg till i Claude Desktop

{
  "mcpServers": {
    "frilanspengen": {
      "url": "https://frilanspengen-scraper.vercel.app/api/mcp"
    }
  }
}

Spara i ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) eller motsvarande Win/Linux-path.

API-exempel

JSON-RPC mot MCP

curl -X POST https://frilanspengen-scraper.vercel.app/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"list_bolag",
                 "arguments":{"sort_by":"avgift"}}}'

JSON direkt

# Alla 17 bolag
curl https://frilanspengen-scraper.vercel.app/api/data

# Enskild bolag inkl. evidence-spans
curl https://frilanspengen-scraper.vercel.app/api/data/frilans-finans

# Full audit-historik (alla Tier 1/2/3-rader, 2 senaste runs)
curl https://frilanspengen-scraper.vercel.app/api/audit/frilans-finans

# Med fler runs
curl https://frilanspengen-scraper.vercel.app/api/audit/frilans-finans?runs=5

Korsreferens — så verifierar du oss

Varje extraherat värde har en ordagrann källspans från bolagets publika sida. För att korsreferera:

  1. Anropa get_audit(id) via MCP, eller /api/audit/{id}.
  2. För varje fält: notera raw_html_span och scrape_run_id.
  3. Anropa /api/status för att hitta källans URL och datum (samma last_scraped som i get_bolag).
  4. Hämta bolagets nuvarande publika sida (URL i data_source_url) och kontrollera att raw_html_span fortfarande finns där.
  5. Om spans:en inte finns längre = bolaget har ändrat texten sedan vår senaste verifiering (tisdag 06:00 UTC). Rapportera till partners@frilanspengen.se.

Citation-policy

Returnerad data är fri att använda under CC-BY-4.0. Vi ber bara om:

Kontakt

Frågor, signoff-förfrågningar, eller om du upptäcker en felaktig spans: mejla partners@frilanspengen.se. Inga API-keys behövs för att läsa publik data.