API Edgepedia
Ponad 500 000 artykułów encyklopedycznych, a ich liczba stale rośnie — w formacie JSON. Bezpłatnie. Bez klucza i rejestracji. Użytek komercyjny z podaniem źródła. Trenowanie AI dozwolone dla wszystkich.
Wypróbuj
- www.edgepedia.org/api/v1/search?q=koala
- www.edgepedia.org/api/v1/articles/koala
- www.edgepedia.org/api/v1/random
- www.edgepedia.org/api/v1/topics
Endpointy służące do odczytu korzystają z metody GET; migracja, operacje wsadowe i przesyłanie tekstu — z POST. Każdy endpoint zwraca JSON dowolnemu programowi lub stronie internetowej (CORS dopuszcza każde źródło). Opis do odczytu maszynowego: /openapi.json, z przykładową odpowiedzią dla każdego endpointu; ten sam opis w formacie OpenAPI 3.0, definicje funkcji dla modeli, typy TypeScript i kolekcje żądań znajdują się poniżej, w sekcji Wygenerowane pliki.
Karty artykułów
Wybrano: Cantor's diagonal argument
Tytuł artykułu, pełne streszczenie i informacja o źródle — Edgepedia — w formie karty do umieszczenia na Twojej stronie.
/embed/{id}?theme=auto udostępnia kartę na podstawie kanonicznego identyfikatora artykułu. Dostępne warianty wyglądu to auto, light i dark. Opcjonalny skrypt /assets/edgepedia-embed.js dopasowuje ramkę do jej zawartości; bez niego ramka pozostaje czytelna i można ją przewijać.
Działa również /embed/{slug}: przekierowuje do karty pod identyfikatorem artykułu, zachowując motyw. Edgepedia jest też dostawcą oEmbed: GET /oembed?url={article or card URL}&format=json zwraca jako html ten sam kod osadzania co powyższy kreator, wraz z tytułem, szerokością i wysokością; uwzględnia maxwidth i maxheight. Każda strona artykułu z korpusu General zawiera w swoim <head> odsyłacz do adresu oEmbed, dzięki czemu WordPress, Discourse i inne systemy obsługujące oEmbed zamieniają wklejony link do Edgepedii w kartę.
Endpointy
| Endpoint | Zwracane dane |
|---|---|
/api/v1/search?q=words | Dopasowania tytułów i innych nazw, od najlepszych. Szukaj nazwy tematu, nie zadawaj pytania. Każdy wynik zawiera: identyfikator, tytuł, temat najwyższego poziomu, tekst podglądu, linki i sposób dopasowania (match, confidence). Słowa będące nazwą tematu, np. „pisarze science fiction”, zwracają też topics, czyli link do należących do niego artykułów. limit określa liczbę wyników na stronie, od 1 do 30 (domyślnie 10); page pozwala przechodzić między stronami, a strona poza zakresem jest pusta. Działają też inne nazwy i nazwy z literówkami: „zhu yuanzhang” znajduje cesarza Hongwu, a „siddartha” zwraca did_you_mean. Więcej opcji poniżej, w sekcji Wyszukiwanie. |
/api/v1/articles/{slug} | Artykuł w formacie Markdown, jego ścieżkę w drzewie kategorii, pozycje w drzewie geograficznym (geo), datę ostatniej aktualizacji i informację o źródle do wyświetlenia. Działa dowolna nazwa (Mount_Fuji, tytuł, pełny adres), a opcje pozwalają uzyskać sekcję, konspekt, fragmenty lub inne formy danych: zob. poniżej Odczyt artykułu. |
/api/v1/articles?id={id} | To samo, według identyfikatora. Stare identyfikatory artykułów nadal prowadzą do treści po migracji korpusu; identyfikatory kategorii mogą się zmienić przy przebudowie drzewa. Adres może się zmienić; stary nadal zwraca odpowiedź, z moved_from. ids= przyjmuje do 10 identyfikatorów naraz. |
/api/v1/leads?ids={id},{id} | Do 50 artykułów według identyfikatora, każdy w postaci wyniku wyszukiwania (identyfikator, tytuł, kategoria najwyższego poziomu, tekst podglądu, linki), na potrzeby strony z kartami. Identyfikatory przeniesione lub scalone zwracają artykuł docelowy pod kluczem odpowiadającym żądanemu identyfikatorowi; id wyniku jest identyfikatorem kanonicznym. Identyfikatory nieznane lub niedostępne są pomijane. |
/api/v1/random | Jeden losowy artykuł. new=1 wybiera spośród najnowszych artykułów; topic= lub geo= wybiera z gałęzi pod danym węzłem. |
/api/v1/related/{slug} | Artykuły sąsiadujące w jednym wywołaniu: do 10 najbliższych w tej samej kategorii, po 3 z maksymalnie 8 sąsiednich kategorii oraz do 10 najbliższych w każdym węźle geograficznym, do którego należy artykuł. Także ?id={id}. by=links zwraca zamiast tego artykuły cytowane wraz z nim. |
/api/v1/topics | Szczyt drzewa tematów. |
/api/v1/topics/{id} | Ścieżkę tematu, jego podtematy z liczbami artykułów oraz wszystkie należące do niego artykuły, po 30 na stronę. format=mermaid przedstawia jego poddrzewo. |
/api/v1/geo | Drzewo geograficzne: regiony, każdy ze swoimi okresami. |
/api/v1/geo/{id} | Węzeł geograficzny o strukturze takiej jak kategoria: jego ścieżkę, węższe węzły i artykuły, po 30 na stronę. Region zawiera jedynie listę swoich okresów. |
POST /api/v1/ids/translate | Przy włączonej migracji v1.5: wyślij {"ids":["old-id", "another-id"]} (do 500 różnych identyfikatorów). Odpowiedź przyporządkowuje przeniesionym identyfikatorom ich kanoniczne identyfikatory docelowe; identyfikatory niezmienione lub nieznane są pomijane. Zapisuj punkty kontrolne po ukończeniu kolejnych partii i stosuj się do Retry-After. |
Tekst podglądu wykorzystuje fragment z korpusu, jeśli jest dostępny, a w przeciwnym razie początek artykułu. Rekordy i wyniki mające taki fragment zawierają go również jako snippet; markdown pozostaje pełnym tekstem artykułu. node, jeśli występuje, oznacza aktualny węzeł artykułu w drzewie pojęć.
Każdy artykuł jest również dostępny w formacie Markdown pod własnym adresem. Dodaj .md: www.edgepedia.org/koala.md.
Serwer MCP
https://www.edgepedia.org/mcp. Dodaj go do Claude jako niestandardowy konektor, do ChatGPT z włączonym trybem deweloperskim, do VS Code lub Cursor jednym kliknięciem albo do dowolnego innego klienta MCP, podając jego adres. Bez klucza i logowania. Pięć narzędzi tylko do odczytu: search (przyjmuje nazwę tematu, zwraca pasujące artykuły, a także kategorię, jeśli podane słowa są jej nazwą), fetch (jeden artykuł w formacie Markdown, z informacją o źródle, ścieżką kategorii i danymi geograficznymi; citations: false daje tekst krótszy o około jedną czwartą; identyfikator topic: zwraca kategorię nadrzędną, węższe kategorie i artykuły, po 120 na page; topic:root i topic:geo to szczyty drzew kategorii i geograficznego), related (artykuły sąsiadujące w tej samej kategorii, pobliskich kategoriach i drzewie geograficznym; by: "links" daje artykuły cytowane wraz z nim), connect (from, to: łańcuch linków między dwoma artykułami, w postaci zwracanej przez /api/v1/path) oraz resolve (name, z opcjonalnymi context i type: artykuł, do którego najprawdopodobniej odnosi się nazwa, w postaci zwracanej przez /api/v1/resolve). Gdy search nie znajduje pasującego tytułu, za dopasowaniami tytułów pojawiają się artykuły z dopasowaniem w tekście, oznaczone match: fulltext, mieszczące się w limicie limit i wliczane do pages. Błąd narzędzia jest tekstem odczytywanym przez model (z identyfikatorami did_you_mean w przypadku identyfikatora, którego nie ma żaden artykuł); jego kod jest przekazywany w _meta["ai.edgechat/error"], nigdy w structuredContent. fetch z links: "in" przyjmuje links_page, aby pobrać kolejnych 30 artykułów zawierających link do danego artykułu.
search przyjmuje limit (od 1 do 30, domyślnie 10), page, first, topic i sort, a zwraca page i pages; fetch przyjmuje opisane poniżej opcje artykułu oraz ids do pobierania kilku artykułów naraz. Każdy wynik zawiera canonical_id, czyli stały identyfikator artykułu: fetch go przyjmuje, a gdy zapisany przez Ciebie identyfikator lub adres został przeniesiony, fetch zwraca artykuł z moved_from ustawionym na wartość podaną w żądaniu. Wyniki wskazują wydanie korpusu w _meta.corpus_version. Klienci korzystający z protokołu w wersji 2025-06-18 lub nowszej otrzymują też po jednym resource_link na artykuł.
Zasoby: edgepedia://article/{slug} (artykuł w formacie Markdown, ten sam tekst co w fetch) oraz edgepedia://topic/{id} (węższe kategorie i artykuły danej kategorii), oba z uzupełnianiem; uzupełnianie podpowiada też tytuły artykułów dla każdego argumentu wskazującego artykuł. Umiejętność agenta jest również udostępniana przez MCP (skills/list, skills/get), jako skill://edgepedia/SKILL.md. GET pod adresem /mcp zwraca kartę serwera w formacie JSON. Klienci akceptujący wyłącznie text/event-stream otrzymują każdą odpowiedź jako pojedyncze zdarzenie SSE message. Skrót sha256 listy narzędzi jest przekazywany w _meta każdej odpowiedzi (ai.edgechat/tools-sha256), dzięki czemu zmiana opisu narzędzia jest widoczna.
Windows (wersja zapoznawcza, kompilacja 26220.7262 lub nowsza): odr.exe mcp add --uri https://www.edgepedia.org/mcp. Wiersze konfiguracji dla wszystkich pozostałych klientów, umiejętność agenta i przykłady: github.com/EdgePlat/edgepedia-mcp.
Nie korzystasz z MCP albo masz klienta obsługującego wyłącznie starszy transport SSE? Udostępnij modelowi dwie funkcje wywołujące /api/v1/search i /api/v1/articles/{slug} albo pobierz gotowe z /tools.json. Adresy starszego transportu (/sse, /mcp/sse) zwracają 404 z treścią wskazującą https://www.edgepedia.org/mcp.
Limity
600 żądań na minutę i 100 000 dziennie na adres IP, zarówno dla API, jak i serwera MCP. Każda odpowiedź podaje oba okna czasowe w RateLimit-Policy. Po przekroczeniu limitów API zwraca 429 z Retry-After i RateLimit; wywołanie narzędzia MCP zwraca błąd narzędzia, którego retry_after podaje liczbę sekund. Liczniki są prowadzone osobno dla każdej instancji serwera, wyznaczają więc pułap, poniżej którego należy pozostać, a nie dokładny pomiar zużycia. Korzystaj z pamięci podręcznej. Tłumaczenie identyfikatorów zlicza każdy żądany identyfikator osobno; partie /leads sprawdzające stare identyfikatory również są rozliczane za każdy stary identyfikator. W pozostałych operacjach wsadowych każdy identyfikator lub nazwa liczy się jako jedno żądanie, a w przypadku adnotowania — każde 1000 znaków.
Licencja
Licencja społecznościowa Edgepedia 1.0: bezpłatnie z podaniem źródła, również do użytku komercyjnego. Trenowanie AI jest dozwolone dla wszystkich, a wyniki generowane przez model nie wymagają podania źródła. W pozostałych zastosowaniach organizacje o przychodach powyżej 100 mln USD lub mające ponad 100 mln użytkowników miesięcznie muszą uzyskać osobną licencję.
Podawanie źródła: wszędzie, gdzie wyświetlasz tekst artykułu, zamieszczaj jego wiersz credit wraz z linkiem. Odpowiedzi zawierające artykuł udostępniają go też w postaci gotowej do wklejenia jako credit_md i credit_html oraz license.spdx (LicenseRef-Edgepedia-Community-1.0). Odpowiedzi API z artykułami oraz odpowiedzi /leads zawierają Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" i X-License: LicenseRef-Edgepedia-Community-1.0.
Aplikacja EdgeChat, jej Edge Apps oraz nasze oprogramowanie są bezpłatne, ale własnościowe: nie udostępniamy kodu źródłowego i nie wolno ich kopiować, modyfikować ani dalej rozpowszechniać (Umowa licencyjna EdgeChat).
Błędy
JSON: { "error": { "code": "not_found", "message": "…" } }. 400 — brak q, 404 — nie znaleziono, 410 — usunięto, 413 — tekst zbyt długi, 429 — zbyt wiele żądań, 503 — spróbuj ponownie. Odpowiedź 404 wskazuje następne wywołanie: hint, next (adres URL), a w przypadku adresu artykułu, pod którym nic nie znaleziono, także did_you_mean z trzema najbliższymi tytułami. Błąd „nie znaleziono” narzędzia MCP fetch zawiera to samo did_you_mean.
Zmiany
Wersja 1 zachowuje swoją strukturę: pola mogą być dodawane, ale nigdy nie są przemianowywane ani usuwane. Zmiany w samej Edgepedii są opisane pod adresem /edgepedia/updates. Gdy wydanie przebudowuje drzewo kategorii, jak miało to miejsce w wersji 1.8.0, przeniesiony identyfikator kategorii zwraca 301 z nowym identyfikatorem, a /api/v1/changes?since=<release> wymienia wszystkie artykuły dodane, zmienione, przeniesione lub usunięte od wskazanego wydania.
/api/v1 podaje corpus_version, corpus_updated i release_notes. Określają one opublikowane wydanie korpusu General i datę jego publikacji, a nie datę ostatniej edycji każdego artykułu. Te same metadane pojawiają się w instrukcjach serwera MCP. Wydania korpusu nie zmieniają wersji oprogramowania API ani MCP. Zawarte tam id_policy określa gwarancje dotyczące identyfikatora: wydanie może zmienić numerację identyfikatorów lub je scalić, jak w wersji 1.5, a stare identyfikatory nadal zwracają odpowiedzi za pośrednictwem 308 i POST /api/v1/ids/translate.
Coś nie działa? Zgłoś problem.
Dokumentacja szczegółowa
Endpointy i pola korzystające z danych pochodnych (istotność, poziom trudności tekstu, linki, daty, inne nazwy i indeks pełnotekstowy) zwracają 503 z Retry-After albo pomijają dane pole, dopóki dane te nie zostaną opublikowane wraz z magazynem danych.
Odczyt artykułu
/api/v1/articles/{slug} i narzędzie MCP fetch przyjmują poniższe opcje; bez nich odpowiedź zawiera cały artykuł.
| Opcja | Zwracane dane |
|---|---|
section={heading} | Jedną sekcję wskazaną nagłówkiem lub zawartym w nim słowem (section=etymology znajduje „Name and etymology”; section=lead oznacza wstęp), wraz z jej podsekcjami. Nieznany nagłówek powoduje odpowiedź 404 z sections artykułu. |
outline=1 | outline: wszystkie nagłówki wraz z rozmiarem ich sekcji w tokenach. |
max_tokens={n} | Tekst skrócony do około n tokenów na granicy sekcji lub akapitu, z tokens_estimate, truncated i next_cursor; przekaż go jako cursor z tym samym max_tokens, aby otrzymać resztę. |
length=snippet, length=lead | Fragment albo tytuł i pierwszy akapit zamiast całego tekstu. |
format=text, html, jsonld, turtle, tables | Odpowiedź w postaci zwykłego tekstu, wyrenderowanej treści albo publicznych pól w formacie JSON-LD lub Turtle; tables podaje każdą tabelę jako columns i rows, jako csv oraz z odwołaniami do źródeł przeniesionymi do cites i sources. |
chunks=1 | chunks: artykuł podzielony na akapity, każdy ze stałym identyfikatorem utworzonym na podstawie ścieżki nagłówków (geology-2) oraz z cite_url. |
q={words}&k={1–10} | passages: k akapitów (domyślnie 3) najlepiej pasujących do podanych słów, każdy z cite_url. |
quote={sentence or chunk id} | cite_url: adres artykułu z fragmentem tekstowym otwierającym stronę w danym miejscu; quote_found informuje, czy artykuł zawiera ten fragment. |
cite={format} | cite: opis bibliograficzny artykułu w postaci zwracanej przez /api/v1/cite. |
Każda odpowiedź zawierająca artykuł zawiera też speakable (fragment w postaci, którą może odczytać asystent głosowy). importance i rank (PageRank obliczany na podstawie linków między artykułami; 1 oznacza pozycję najbardziej centralną; to miara oparta na liczbie linków, nie ocena opisywanego tematu), words, reading_grade (Flescha–Kincaida) i reading_minutes pojawiają się tylko wtedy, gdy wymienia je fields= (?fields=title,importance,rank); narzędzie MCP fetch zawiera je zawsze. next=1 dodaje do 5 propozycji dalszej lektury. citations=false zastępuje linki do źródeł w tekście znacznikami [n] w markdown, chunks i passages, tak jak robi to citations: false w MCP. Adres, którego nie ma żaden artykuł, jest odczytywany jako identyfikator artykułu (/api/v1/articles/ep7rbwcy0a) albo jego tytuł, bez rozróżniania wielkości liter i znaków diakrytycznych (/api/v1/articles/paris); adres zapisany małymi literami z łącznikami, który nie spełnia tych warunków, zwraca 404, chyba że dodasz ?suggest=1. Natomiast adres z wielkimi literami, spacjami lub podkreśleniami (/api/v1/articles/Albert_Einstein) jest odczytywany jako nazwa, więc przybliżone dopasowanie zwraca najlepszy wynik wyszukiwania z resolved_by: search. Jeśli podana nazwa nie jest adresem artykułu, odpowiedź informuje, jak ją odczytano (resolved_from, resolved_by: adres, tytuł lub wyszukiwanie), i wymienia 3 inne artykuły w nearest. /api/v1/articles?ids={slug or id},{name} zwraca do 10 artykułów jako articles (każdy z nazwą, na którą odpowiada, w asked) oraz missing; każda opcja dotyczy każdego z nich.
Cytowanie artykułu
/api/v1/cite/{slug}?format= udostępnia opis bibliograficzny w formacie csl (CSL-JSON, domyślnie), bibtex, ris, apa, mla, chicago lub harvard, wraz z informacją o źródle jako zwykłym tekstem oraz w formatach Markdown i HTML; /api/v1/cite?ids={id},{slug} robi to samo dla maksymalnie 50 artykułów. Autorem jest Edgepedia (EdgeChat); style APA, MLA, Chicago i Harvard oznaczają kursywę tytułu gwiazdkami, tak jak Markdown. Karty artykułów zawierają ten sam opis bibliograficzny w niewidocznej postaci, jako COinS i JSON-LD, do odczytu przez menedżery bibliografii.
Wyszukiwanie
match | Kiedy | confidence |
|---|---|---|
exact | Tytuł jest identyczny z zapytaniem. | 1,0 dla pierwszego takiego wyniku, 0,9 dla kolejnego |
alias | Dopasowano inną nazwę lub inicjały tytułu („mlk”). | 0,8; 0,7 dla pierwszego wyniku niezawierającego żadnego słowa z zapytania; 0,6 dla zapytania po transliteracji |
misspelling | Wyszukiwarka poprawiła zapytanie (did_you_mean). | 0,5 × część wpisanego zapytania zachowana po korekcie |
partial | Niektóre słowa z zapytania występują w tytule albo tylko w tekście. | 0,2 + 0,5 × odsetek słów z zapytania występujących w tytule; 0,2, jeśli występują tylko w tekście |
fulltext | Nie dopasowano tytułu ani innej nazwy, więc przeszukano tekst artykułów (BM25): opis pozwala znaleźć artykuł, którego nazwy nie znasz. | co najmniej 0,2 |
none | Nic nie pasuje. Odpowiedź jest pusta. | 0 |
Poziom pewności wynika ze stałej reguły, nie jest skalibrowanym prawdopodobieństwem; jeśli najlepszy wynik ma wartość poniżej 0,2, odpowiedź jest pusta. Każdy wynik zawiera highlight — zdanie ze streszczenia, w którym występuje najwięcej słów z zapytania. Wyszukiwanie, które niczego nie znalazło, jest ponawiane jeden raz z użyciem liter łacińskich (cyrylica, alfabet grecki, kana i hangul podlegają transliteracji, cyfry oznaczające tony w pinyin są pomijane, a podwojone samogłoski w rōmaji — skracane); odpowiedź oznacza je jako searched_as. Znaki chińskie nie podlegają transliteracji.
| Opcja | Działanie |
|---|---|
first=true | Tylko najlepsze dopasowanie albo żadne. |
topic={id}, geo={id} | Tylko artykuły pod wskazanym węzłem kategorii lub drzewa geograficznego; geo filtruje wszystkie dopasowania, maksymalnie 1000, a scope informuje o zakresie odpowiedzi. |
sort=central | Najpierw tematy, do których prowadzi najwięcej linków, spośród wszystkich dopasowań, maksymalnie 1000. |
max_grade={grade} | Tylko artykuły o poziomie trudności tekstu nie wyższym niż wskazany poziom szkolny. |
facets=1 | Liczby dopasowań według kategorii najwyższego poziomu i regionu geograficznego, dla wszystkich dopasowań, maksymalnie 1000 (facets.counted). |
Każda odpowiedź
fields=a,b zachowuje tylko wskazane klucze każdego wyniku (lub odpowiedzi, jeśli nie ma w niej wyników); obudowa odpowiedzi (total, page, next, license) pozostaje. Odpowiedź 200, którą można zapisać w pamięci podręcznej, zawiera ETag: odeślij tę wartość jako If-None-Match, a jeśli odpowiedź się nie zmieniła, otrzymasz 304 bez treści. Last-Modified to data wydania korpusu, podawana wyłącznie informacyjnie. Edgepedia-Corpus-Version wskazuje wydanie korpusu, a Content-Digest jest skrótem SHA-256 treści odpowiedzi (RFC 9530); .md artykułu również zawiera oba te pola.
Więcej endpointów
| Endpoint | Zwracane dane |
|---|---|
/api/v1/articles?after={id}&limit={1..1000} | Wszystkie artykuły z korpusu General, przeglądane w stałej kolejności: {id, slug, title, api_url} i next (na końcu null). Puste after= rozpoczyna przeglądanie od początku; można je wznowić po dowolnym identyfikatorze, nawet usuniętym. |
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geo | Całe drzewa kategorii i geograficzne: nodes: [[id, label, parent index, own articles]]; identyfikator zaczynający się od kropki jest dalszym ciągiem identyfikatora rodzica. |
/api/v1/releases | Wydania korpusu, od najnowszego, oraz current. |
/api/v1/health | application/health+json: pass, warn lub fail (503). |
/api/v1/manifest | Przekierowanie do jednego pliku JSONL skompresowanego gzip, z jednym artykułem w wierszu: { id, slug, title, updated, sha256, topic } (sha256 zawartości .md artykułu). Pobierz go raz, aby utworzyć kopię lustrzaną Edgepedii. Suma kontrolna dotyczy opublikowanego tekstu, przed poprawkami zgłoszonymi przez czytelników: artykuł zmieniony od czasu wydania wskutek takiego zgłoszenia nie będzie z nią zgodny aż do następnego wydania. |
/api/v1/changes?since={release} | Pliki zmian od wskazanego wydania do obecnego, w kolejności (strumień zmian zaczyna się od wersji 1.5: najwcześniejsze jest since=1.5); każdy wiersz ma postać { op, id, … }, a op przyjmuje jedną z wartości: added, changed, moved (from_slug to stary adres) lub removed. |
/api/v1/events/{slug} | Zdania artykułu zawierające datę: { date, precision, text, para }, date jako YYYY, YYYY-MM lub YYYY-MM-DD (wartości ujemne przed naszą erą: -0044-03-15). Daty p.n.e. są zgodne z konwencją historyczną, nie z astronomiczną numeracją lat: -0044 oznacza 44 r. p.n.e. (standardowy parser ISO 8601 odczytałby tę wartość jako 45 r. p.n.e.). Dowodem jest zdanie: przeczytaj je, zanim uznasz datę za fakt. |
/api/v1/aliases/{id} | Inne nazwy artykułu, w tym skrótowce wymienione w artykułach („NASA”); pomija błędną pisownię i warianty różniące się wielkością liter, a spośród dwóch zapisów tej samej nazwy zachowuje ten bez kropek („WHO”, nie „W.H.O.”). |
Rozpoznawanie nazw, adnotowanie i uzgadnianie encji
Na wejściu dowolny tekst, na wyjściu identyfikatory artykułów — bez modelu i bez osadzeń wektorowych. Tekst przesyłany do adnotowania, klasyfikacji i analizy geograficznej nigdy nie jest zapisywany w logach ani przechowywany.
| Endpoint | Zwracane dane |
|---|---|
/api/v1/resolve?name=Mercury&context=planet | Artykuł, do którego najprawdopodobniej odnosi się nazwa: result, confidence, ambiguous, match (exact, alias, anchor, partial lub none) oraz alternatives. type= ogranicza kandydatów do jednego identyfikatora kategorii (gdy nie należy do niej żaden z pierwszych 30 wyników dla nazwy, żądanie dla pojedynczej nazwy przeszukuje kolejnych 60); limit= od 1 do 10. POST przyjmuje do 50 nazw: { "names": ["Paris", "Koala"] } lub { "queries": [{ "name": "Mercury", "context": "planet" }] }. Jeśli sama nazwa nie wskazuje jednoznacznie artykułu, odpowiedź zawiera ambiguous: true, a w result — najbardziej prawdopodobne dopasowanie; przekaż context, aby dokonać wyboru. |
/api/v1/surface?form=mercury | Wszystkie artykuły, do których odsyła dokładnie ta fraza w linkach samego korpusu, wraz z liczbą linków i udziałem każdego artykułu (commonness). |
/api/v1/suggest?prefix=koa | Najpierw artykuł o dokładnie takim tytule, następnie artykuł o dokładnie takiej innej nazwie, potem tytuły zaczynające się od podanego prefiksu, a na końcu inne nazwy zaczynające się od niego (matched podaje tę nazwę); do pól wyszukiwania i interfejsów głosowych. |
POST /api/v1/annotate | { "text": "…" } (najwyżej 20 000 znaków): każdą frazę z przypisanym linkiem wraz z jej pozycjami w tekście (start, end, w jednostkach kodowych UTF-16, tak jak JavaScript indeksuje ciągi znaków: w Pythonie znak spoza podstawowej płaszczyzny wielojęzycznej, na przykład emoji, należy liczyć jako dwa), artykułem i poziomem pewności. ?format=html zwraca też tekst ze znakami specjalnymi zastąpionymi encjami HTML i każdą frazą opatrzoną linkiem. |
POST /api/v1/classify | { "text": "…" }: kategorie, których dotyczy tekst, z punktacją wyznaczoną na podstawie ścieżek kategorii wspomnianych w nim artykułów, oraz udziały kategorii najwyższego poziomu. |
POST /api/v1/geoparse | { "text": "…" }: miejsca i okresy wymienione w tekście, umiejscowione w drzewie geograficznym (nodes, regions, places, periods); niegeograficzna gałąź drzewa (geo.nongeo) nigdy nie jest miejscem. |
/api/v1/mentions?term=CRISPR | Artykuły, które wspominają dany temat, ale nie odsyłają do poświęconego mu artykułu; complete: false oznacza, że lista artykułów zawierających link została ucięta. |
/api/v1/reconcile | Endpoint zgodny z Reconciliation Service API 0.2: manifest, wsadowe queries (GET lub POST), podpowiedzi encji, typów i właściwości, podgląd oraz rozszerzanie danych (title, url, excerpt, topic, topic_path, importance_rank). JSONP z callback=. W OpenRefine: Reconcile › Start reconciling › Add standard service, a następnie wklej https://www.edgepedia.org/api/v1/reconcile. |
Graf linków, daty i listy
Diagramy (format=mermaid) mają postać tekstu Mermaid do wyrenderowania przez system, który je wyświetla.
| Endpoint | Zwracane dane |
|---|---|
/api/v1/links/{slug} | Linki artykułu do innych artykułów, w kolejności występowania w tekście, każdy z tekstem linku i zdaniem, w którym się znajduje. |
/api/v1/backlinks/{slug}?page= | Artykuły, które do niego odsyłają, po 30 na stronę, od najważniejszych, wraz z tekstem linku. |
/api/v1/path?from=&to= | Najkrótszy łańcuch linków między dwoma artykułami (najwyżej 6 przejść, w miarę możliwości z pominięciem węzłów o bardzo wielu połączeniach), wraz ze zdaniem zawierającym każde przejście. Na serwerze MCP nosi nazwę connect. |
/api/v1/compare?a=&b= | Dwa artykuły obok siebie: wstępy, ścieżki kategorii, najgłębszą wspólną kategorię, łączący je łańcuch, linki wspólne i odrębne oraz tabelę Najważniejsze fakty z każdego z nich. |
/api/v1/graph/{slug}?depth=1|2&limit= | Do limit (domyślnie 50, najwyżej 200) najważniejszych sąsiadów artykułu oraz wszystkie linki między nimi. complete: false (tutaj, przy linkach przychodzących i przy rank/top) oznacza, że odpowiedź została skrócona z powodu wynoszącego około sekundy limitu czasu endpointu; taka odpowiedź jest przechowywana w pamięci podręcznej tylko przez minutę. |
POST /api/v1/context | { "ids": [...] }, do 50 identyfikatorów lub adresów (przyjmowanych również przez /rank?ids= i /leads?ids=): linki między nimi, artykuły połączone linkami z większością z nich, najgłębszą wspólną kategorię i wspólne miejsce oraz wstęp każdego artykułu. |
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit= | Istotność według PageRank: suma pr w całym korpusie wynosi 1, a pozycja 1 oznacza artykuł najbardziej centralny. Uwaga na nazwy: importance w /search i artykułach to ta pozycja wyrażona jako percentyl w skali od 0 do 1; importance w /resolve jest surową wartością pr, a w /leads — { pr, rank }. |
/api/v1/timeline?topic=|geo=&from=&to= | Zdania z datami pochodzące z artykułów danej kategorii lub miejsca, od najstarszych, po 50 na stronę; lata p.n.e. mają wartości ujemne. Węzeł zachowuje najwyżej 200 zdarzeń rozłożonych w swoim zakresie dat, a from i to filtrują tę próbkę; odpowiedź pochodząca z próbki, która osiągnęła ten limit, zawiera sampled: true oraz jej cap, a total podaje liczebność próbki. |
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year} | Zdarzenia z danego dnia roku (domyślnie z dzisiejszego dnia według UTC) albo z jednego roku (od -9999 do 2100). Dzień obejmuje najwyżej 500 zdarzeń, a rok — 2000; po osiągnięciu limitu odpowiedź zawiera sampled: true. |
/api/v1/featured?date=, /api/v1/featured.xml | Wyróżniony artykuł dnia (Ciekawostka na dziś na stronie głównej) oraz kanał Atom z ostatnich dziesięciu dni. |
/api/v1/list?topic=|geo=&period=&type=person | Artykuły danej kategorii albo danego miejsca i okresu (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE), po 30 na stronę; type=person pozostawia tylko osoby. Wiersze listy geograficznej zawierają geo, ale nie id (aby je uzyskać, pobierz artykuł). |
/api/v1/keyterms?topic=|geo=&limit= | Tytuły i inne nazwy z poddrzewa, do wstępnego przygotowania systemu rozpoznawania mowy. |
/api/v1/stats?topic=|geo=&by=period | Tylko liczby: artykułów, linków i innych nazw w korpusie albo węźle i jego dzieciach. Tutaj articles liczy odrębne artykuły; w /geo i /trees/geo liczy przypisania, więc artykuł należący do dwóch okresów w regionie jest tam liczony dwukrotnie. |
Odkrywanie i inne protokoły
- Karta serwera MCP: /.well-known/mcp/server-card.json (także
/mcp/server-card): nazwa, endpoint, narzędzia i wersje, bez nawiązywania połączenia. Konfiguracja rejestru:/.well-known/mcp/config-schema.jsoni/.well-known/mcp/examples.json. - Katalog AI: /.well-known/ai-catalog.json: wszystkie sposoby dostępu (MCP, to API, A2A, NLWeb i umiejętność agenta) wraz z przykładowymi zapytaniami.
- Katalog API: /.well-known/api-catalog, zestaw linków zgodny z RFC 9727, wskazujący to API, jego opis i tę dokumentację.
- Umiejętność agenta: /.well-known/agent-skills/index.json wymienia
SKILL.mdwraz ze skrótem sha256. - OpenSearch: /opensearch.xml dodaje Edgepedię jako dostawcę wyszukiwania.
- A2A:
https://www.edgepedia.org/a2a(JSON-RPC; A2A 1.0SendMessagei 0.3message/send; karta pod adresem/.well-known/agent-card.json). Nazwa tematu zwraca pięć najlepszych wyników wśród artykułów; adres artykułu zwraca jego treść w formacie Markdown wraz z notą atrybucyjną. Odpowiedź jest zawsze wiadomością, nigdy zadaniem, a te same metody są obsługiwane także pod adresem/mcp. - NLWeb:
https://www.edgepedia.org/ask?query=Mount%20Fuji(GET albo POST z treścią w formacie JSON lub formularza) zwraca odpowiedź w postaci listy zgodnej z NLWeb, z jednym obiektemschema_objectze schema.org na wynik;streaming=trueprzesyła listę jako zdarzenia wysyłane przez serwer (SSE). Nie jest wywoływany żaden model. - Formy artykułu do odczytu maszynowego: pod adresem artykułu zwracana jest forma wskazana w nagłówku
Accept:text/markdown(z szacunkową wartościąx-markdown-tokens),application/json(odpowiedź tego API) alboapplication/ld+json; każda inna wartość powoduje zwrócenie strony. Strony artykułów zawierają nagłówekLinkwskazujący te postacie, licencję, katalog API i opis OpenAPI.
Wygenerowane pliki
Tworzone na podstawie /openapi.json, więc zawsze pozostają z nim zgodne.
| Plik | Zawartość |
|---|---|
| /openapi-3.0.json | Ten sam opis w formacie OpenAPI 3.0.3, dla narzędzi, które nie odczytują wersji 3.1. |
| /arazzo.json | Przepływ pracy w formacie Arazzo 1.0: wyszukanie, pobranie najlepszego dopasowania, a następnie powiązanych z nim artykułów. |
| /tools.json | Każdy endpoint JSON jako funkcja, którą może wywołać model, w formatach OpenAI, Anthropic i Gemini, a także jako JSON Schema wraz z endpointem. |
| /edgepedia.d.ts | Typy TypeScript dla każdej odpowiedzi i parametrów każdego endpointu. |
| /edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.http | Po jednym przykładowym żądaniu na endpoint dla narzędzi Postman, Bruno, Insomnia oraz VS Code lub JetBrains. |
Przesyłaj User-Agent z nazwą swojego programu, tak jak w kolekcjach (edgepedia-collection/1).