archive-org-mcp 1.0.4 → 1.0.6

package/README.md

@@ -24,4 +24,9 @@ node dist/index.js
 
 Public free APIs only. See `src/api.ts` for exact endpoints.
 
+## Licence — no paywall
 
+Every tool in this package is free: no licence key, no premium tier, no hosted
+licence gateway. The paywall machinery this repo once carried (per-tool licence
+checks and paid hosted endpoints) was removed repo-wide on 2026-10-17. Nothing
+that this package installs or calls asks you to pay.

package/dist/api.js

@@ -289,3 +289,57 @@ export async function searchProfile(args) {
     lines.push("  every figure above is tallied from the rows the search returned, and the sample size is stated rather than implied.");
     return lines.join("\n");
 }
+
+const CDX = 'http://web.archive.org/cdx/search/cdx';
+export async function snapshotTimeline(args = {}) {
+    const raw = String(args?.url ?? '').trim();
+    if (!/^[a-z][a-z0-9+.-]*:\/\//i.test(raw))
+        throw new Error('Give a full URL including the scheme, like https://example.com/page.html');
+    const limit = Math.min(Math.max(Number(args?.limit ?? 500) || 500, 1), 3000);
+    const qs = new URLSearchParams({
+        url: raw,
+        output: 'json',
+        limit: String(limit),
+        fl: 'timestamp,original,mimetype,statuscode,digest,length',
+    });
+    if (args?.from)
+        qs.set('from', `${args.from}0101`);
+    if (args?.to)
+        qs.set('to', `${args.to}1231`);
+    const res = await fetch(`${CDX}?${qs}`, {
+        headers: { 'User-Agent': 'mrfentmen-archive-org-mcp/1.0', Accept: 'application/json' },
+        signal: AbortSignal.timeout(40000),
+    });
+    if (!res.ok)
+        throw new Error(`Wayback CDX returned ${res.status}`);
+    const body = (await res.json());
+    if (!Array.isArray(body) || body.length < 2)
+        throw new Error(`The Wayback Machine has no captures for ${raw} in that window`);
+    const [head, ...rows] = body;
+    const idx = (name) => head.indexOf(name);
+    const ts = idx('timestamp'), mime = idx('mimetype'), code = idx('statuscode'), digest = idx('digest'), len = idx('length');
+    const ok = rows.filter((r) => String(r[code]) === '200');
+    const digests = new Set(ok.map((r) => r[digest]).filter(Boolean));
+    const mimes = new Map();
+    let bytes = 0;
+    const perYear = new Map();
+    for (const r of rows) {
+        mimes.set(r[mime], (mimes.get(r[mime]) ?? 0) + 1);
+        bytes += Number(r[len] ?? 0);
+        const year = String(r[ts]).slice(0, 4);
+        perYear.set(year, (perYear.get(year) ?? 0) + 1);
+    }
+    const topMimes = [...mimes.entries()].sort((a, b) => b[1] - a[1]).slice(0, 5);
+    return [
+        `${raw} — ${rows.length} capture(s) read`,
+        `Successful (200): ${ok.length} · distinct content digests: ${digests.size} · repeats of an archived page: ${ok.length - digests.size}`,
+        `Window: ${String(rows[0]?.[ts]).slice(0, 4)} to ${String(rows[rows.length - 1]?.[ts]).slice(0, 4)}`,
+        `Payload recorded: ${(bytes / 1048576).toFixed(2)} MB across the captures`,
+        `Media types: ${topMimes.map(([m, n]) => `${m} (${n})`).join(', ') || 'none reported'}`,
+        '',
+        'Captures per year:',
+        ...[...perYear.entries()].sort().map(([y, n]) => `${y}: ${n}`),
+        '',
+        `Oldest: http://web.archive.org/web/${rows[0]?.[ts]}/${raw}`,
+    ].join('\n');
+}

package/dist/server.js

@@ -1,6 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { m0_fmtSize, m0_formatItem, m0_getItemDetails, m0_searchItems, m1_formatSnapshot, m1_getAvailability, m1_getSnapshots, m1_getSnapshotText, searchProfile } from "./api.js";
+import { m0_fmtSize, m0_formatItem, m0_getItemDetails, m0_searchItems, m1_formatSnapshot, m1_getAvailability, m1_getSnapshots, m1_getSnapshotText, searchProfile, snapshotTimeline } from "./api.js";
 const text = (value) => ({ content: [{ type: 'text', text: value }] });
 const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
 const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
@@ -119,9 +119,8 @@ export function createServer() {
         }),
         annotations: READ_ONLY,
     }, async (args) => {
-        // TODO: implement timeline locally (paywall removed)
         try {
-            return textError("Not yet implemented: timeline");
+            return text(await snapshotTimeline(args));
         }
         catch (e) {
             return textError(String(e));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archive-org-mcp",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Internet Archive search, item metadata, and Wayback snapshots.",
   "type": "module",
   "main": "dist/index.js",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/mrfentmen/awesome-mcps",
     "source": "github"
   },
-  "version": "1.0.1",
+  "version": "1.0.6",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "archive-org-mcp",
-      "version": "1.0.1",
+      "version": "1.0.6",
       "transport": {
         "type": "stdio"
       }