Vefþjónusta Blaðbera

Fréttasafn Blaðbera, með fréttum allra helstu fréttamiðla landsins, er opið öðrum forritum á tvo vegu:

  • MCP þjónn — fyrir gervigreindarforrit á borð við Claude og ChatGPT. Engan lykil þarf, bara innskráningu.
  • REST vefþjónusta — fyrir eigin forrit og skriftur, með API lykli.
MCP þjónn

Með MCP (Model Context Protocol) getur þú tengt gervigreindarforrit á borð við ChatGPT, Claude og Cursor beint við fréttasafn Blaðbera. Forritið getur þá leitað í fréttum allra helstu fréttamiðla landsins, skoðað nýjustu og mest lesnu fréttirnar og greint umfjöllun yfir tíma — og vísar alltaf í upprunalegu fréttirnar.

Þjónustan er ókeypis fyrir innskráða notendur. Skráðu þig inn eða stofnaðu aðgang með Google eða Apple.

Slóð þjónsins

https://bladberi.is/mcp
ChatGPT
  1. Farðu á chatgpt.com/plugins, smelltu á + og veldu Add custom MCP server.
  2. Gefðu tengingunni nafn (t.d. Blaðberi), settu inn slóðina hér að ofan og veldu OAuth.
  3. Hakaðu við I understand and want to continue og smelltu á Create as a plugin.
  4. Skráðu þig inn á Blaðbera og samþykktu aðganginn.
Claude (claude.ai og Claude Desktop)
  1. Farðu í Settings → Connectors og veldu Add custom connector.
  2. Gefðu tengingunni nafn (t.d. Blaðberi) og settu inn slóðina hér að ofan.
  3. Smelltu á Connect, skráðu þig inn á Blaðbera og samþykktu aðganginn.
Claude Code
claude mcp add --transport http bladberi https://bladberi.is/mcp

Keyrðu síðan /mcp í Claude Code til að skrá þig inn.

Önnur forrit (Cursor, VS Code o.fl.)

Flest MCP forrit styðja OAuth innskráningu sjálfkrafa — settu bara inn slóðina:

{
    "mcpServers": {
      "bladberi": { "url": "https://bladberi.is/mcp" }
    }
  }

Forrit sem styðja ekki OAuth geta notað API lykil sem Bearer tóka:

{
    "mcpServers": {
      "bladberi": {
        "url": "https://bladberi.is/mcp",
        "headers": { "Authorization": "Bearer bladberi_þinn_lykill" }
      }
    }
  }
Verkfæri
  • search_news — Leit í öllu fréttasafninu (lemmuleit: öll beygingarform finnast)
  • get_latest_news — Nýjustu fréttir, síaðar eftir miðli, flokki og tímabili
  • get_popular_news — Mest lesnu fréttirnar á Blaðbera á tilteknu tímabili
  • get_articles — Nánari upplýsingar um fréttir eftir auðkenni
  • news_volume — Fjöldi frétta yfir tíma, eftir miðli eða flokki, t.d. um tiltekið málefni
  • describe_dataset — Miðlar, flokkar og umfang fréttasafnsins

Auk þess fylgja tvö tilbúin fyrirmæli (prompts): news_briefing (fréttayfirlit dagsins) og coverage_analysis (greining á umfjöllun um tiltekið málefni).

Dæmi um spurningar
  • Hvað er helst í fréttum í dag?
  • Hvernig hefur umfjöllun um verðbólgu þróast síðasta árið?
  • Hvaða miðlar hafa fjallað mest um Grindavík?
  • Taktu saman það helsta sem sagt hefur verið um kjaraviðræður í þessari viku.
Takmarkanir
  • Eingöngu lesaðgangur að fyrirsögnum og samantektum frétta, ekki heildartexta greina
  • Um 120 beiðnir á mínútu fyrir hvern notanda (100 með API lykli)
  • Hámark 50 fréttir í hverju svari
Tengd forrit

Skráðu þig inn til að sjá forrit sem tengd eru aðganginum þínum.

REST vefþjónusta

REST vefþjónustan veitir aðgang að nýjustu fréttum, vinsælustu fréttum og leit, með 800 stafa samantekt fyrir hverja frétt.

Fá API lykil

Skráðu þig inn til að fá API lykil.

Auðkenning

API notar header-based auðkenningu. Þú þarft að senda API lykilinn þinn með hverri beiðni:

X-API-Key: bladberi_þinn_lykill_hér
Takmarkanir
  • 100 beiðnir á mínútu fyrir hvern lykil
  • Hámark 50 fréttir í hverri beiðni
  • 800 stafa samantekt fyrir hverja frétt
Endapunktar

1. Nýjustu fréttir

Sækir nýjustu fréttirnar, raðað eftir birtingartíma.

GET /api/v1/news/latest

Query parametrar:

  • limit - Fjöldi frétta (sjálfgefið: 20, hámark: 50)
  • offset - Fjöldi frétta til að sleppa (sjálfgefið: 0)
  • date_from - Byrjunardagsetning (ISO format)
  • date_to - Lokadagsetning (ISO format)
  • source - Fréttamiðill (t.d. "mbl.is", "visir.is")
  • categories - Flokkar, aðskildir með kommu (sjálfgefið: all,domestic,foreign,business — íþróttir ekki með nema óskað sé eftir)

Dæmi:

curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/latest?limit=10"

# Með íþróttafréttum
curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/latest?categories=all,domestic,foreign,business,sport"

Svörun:

{
  "articles": [{
    "id": "123",
    "headline": "Fyrirsögn fréttar",
    "summary": "Allt að 800 stafa samantekt...",
    "source": "mbl.is",
    "published_at": "2024-01-12T10:30:00Z",
    "url": "https://mbl.is/frettir/..."
  }],
  "total": 4523,
  "offset": 0,
  "limit": 20
}

2. Vinsælustu fréttir

Sækir fréttir raðaðar eftir vinsældum (klikkfjölda) innan tilgreinds tímabils.

GET /api/v1/news/popular

Query parametrar:

  • limit - Fjöldi frétta (sjálfgefið: 20, hámark: 50)
  • offset - Fjöldi frétta til að sleppa (sjálfgefið: 0)
  • hours - Fjöldi klukkustunda aftur í tímann (sjálfgefið: 24)
  • date_from - Byrjunardagsetning (ISO format, yfirskrifar hours)
  • date_to - Lokadagsetning (ISO format)
  • source - Fréttamiðill
  • categories - Flokkar, aðskildir með kommu (sýnir íþróttir ef "sport" er innifalið)

Dæmi:

# Vinsælast síðustu 12 klukkustundir
curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/popular?hours=12&limit=10"

# Vinsælast síðustu 7 daga
curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/popular?hours=168&limit=20"

Svörun:

{
  "articles": [{
    "id": "123",
    "headline": "Fyrirsögn fréttar",
    "summary": "Allt að 800 stafa samantekt...",
    "source": "mbl.is",
    "published_at": "2024-01-12T10:30:00Z",
    "url": "https://mbl.is/frettir/...",
    "click_count": 42
  }],
  "total": 150,
  "offset": 0,
  "limit": 20,
  "period": {
    "from": "2024-01-11T10:30:00Z",
    "to": "2024-01-12T10:30:00Z"
  }
}

3. Leita í fréttum

Leit í fyrirsögnum og samantektum frétta; allar beygingarmyndir orða finnast (BÍN).

GET /api/v1/news/search

Query parametrar:

  • q - Leitarorð (skylda)
  • limit - Fjöldi frétta (sjálfgefið: 20, hámark: 50)
  • offset - Fjöldi frétta til að sleppa (sjálfgefið: 0)
  • date_from - Byrjunardagsetning (ISO format)
  • date_to - Lokadagsetning (ISO format)
  • source - Fréttamiðill
  • categories - Flokkar, aðskildir með kommu
  • prefix - Forskeytisleit, "true" til að virkja (t.d. "veð" finnur "veður")

Dæmi:

curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/search?q=veður&limit=5"

# Forskeytisleit
curl -H "X-API-Key: bladberi_þinn_lykill" \
  "https://bladberi.is/api/v1/news/search?q=stjórn&prefix=true&limit=10"

Svörun:

{
  "articles": [{
    "id": "456",
    "headline": "Fyrirsögn fréttar",
    "summary": "Allt að 800 stafa samantekt...",
    "source": "visir.is",
    "published_at": "2024-01-12T10:30:00Z",
    "url": "https://visir.is/..."
  }],
  "total": 42,
  "offset": 0,
  "limit": 20
}
Flokkar

Mögulegir flokkar:

  • all - Allt (óflokkaðar fréttir)
  • domestic - Innlent
  • foreign - Erlent
  • business - Viðskipti
  • sport - Íþróttir
Villukóðar
  • 400 - Ógild beiðni (t.d. vantar leitarorð í /search)
  • 401 - Vantar API lykil eða ógildur lykill
  • 429 - Of margar beiðnir (100 á mínútu). Inniheldur Retry-After header.
  • 500 - Villa á þjóni
Hafðu samband

Spurningar eða vandamál? Sendu tölvupóst á bladberi@bladberi.is

Um Blaðbera·Vefþjónusta·Persónuvernd·Skilmálar