One tool. One endpoint.

Quickstart

Claude Code, one line. It registers a single tool, digest_url, and the agent calls it by itself whenever it meets a social link it cannot open.

claude mcp add --transport http linkdigest \
  https://linkdigest.dev/mcp \
  --header "Authorization: Bearer ld_live_..."

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "linkdigest": {
      "url": "https://linkdigest.dev/mcp",
      "headers": { "Authorization": "Bearer ld_live_..." }
    }
  }
}

First call over REST

curl -X POST https://linkdigest.dev/api/v1/digest \
  -H "Authorization: Bearer ld_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=CEvIs9y1uog"}'

That link is a cached example, so it answers in about a second and costs nothing.

Authentication

Every request carries your key as a bearer token. Keys are created on the API keys page and shown once. A key can be given its own monthly credit cap, so one handed to a script cannot drain the account.

Authorization: Bearer ld_live_...

Accepted links

Paste the link in whatever shape the app gave you. Share-button short links, full page addresses, a profile page with the post open, and the whole share-sheet text with the link buried in it all work — the first link is taken out for you. Measured 2026-09-13: 23 of 24 shapes read in full.

Read one link. Returns the digest, or a job id when the media takes longer than a request can wait.

Example request

curl -X POST https://linkdigest.dev/api/v1/digest \
  -H "Authorization: Bearer ld_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.xiaohongshu.com/discovery/item/6a6bf662000000002402de7e?xsec_token=CBCe01s1uyd2C8uMx6ycYcnEwPV5_31OX1u_I19FCSd54=&xsec_source=app_share", "translate_to": "en", "max_credits": 4}'

Example response

{
  "platform": "xiaohongshu",
  "author": "...",
  "title": "...",
  "posted_at": "2026-09-10",
  "caption": "...",
  "transcript": [{ "t": 0, "text": "..." }],
  "transcript_source": "asr",
  "ocr_text": ["...", "..."],
  "images": [{ "description": "...", "ocr": "..." }],
  "key_points": ["...", "..."],
  "key_point_support": [
    { "point_index": 0, "kind": "transcript", "t": 12.4, "image_index": null, "quote": "...", "verified": true }
  ],
  "coverage": {
    "seconds_transcribed": 95, "duration_seconds": 95, "largest_frame_gap_seconds": 4.2,
    "images_read": 1, "images_total": 1, "transcript_source": "asr",
    "not_captured": ["comments not read"], "links_found": 1
  },
  "links": [
    { "url": "https://arxiv.org/abs/1706.03762", "found_in": "on_screen", "label": "", "kind": "web" }
  ],
  "translation": { "language": "en", "key_points": ["..."] },
  "degraded": [],
  "cached": false,
  "credits": 13
}

Cached links, web pages and short posts come back as 200 straight away. A video that has to be downloaded and transcribed returns 202 with a job id. Collect it with the same key.

# 202 {"pending":true,"jobId":"abc…","poll":"/api/v1/digest/abc…","stage":"fetching"}

curl "https://linkdigest.dev/api/v1/digest/JOB_ID?wait=20" \
  -H "Authorization: Bearer ld_live_..."
# 202 while it runs, 200 with the digest when it is done.
# wait=0..20 holds the request until the job finishes (at most 20 s),
# so a loop with no sleep step (Coze, a Feishu shortcut) still works.

While it runs, stage says what is happening: resolving, fetching, transcribing 5:42 of audio · reading 42 frames, summarising, translating. Transcription and image reading run side by side.

Up to 50 links in one call. Every link is billed exactly as a single call would be: cached links are free, credits are quoted before spend, the key’s cap applies. Collect by polling, or hand over a webhook and the summary is pushed to you.

curl -X POST https://linkdigest.dev/api/v1/digest/batch \
  -H "Authorization: Bearer ld_live_..." \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://www.youtube.com/watch?v=CEvIs9y1uog", "https://www.xiaohongshu.com/discovery/item/6a6bf662000000002402de7e?xsec_token=CBCe01s1uyd2C8uMx6ycYcnEwPV5_31OX1u_I19FCSd54=&xsec_source=app_share"],
       "webhook_url": "https://example.com/hooks/linkdigest",
       "translate_to": "en"}'

# 202
{ "batch_id": "…", "status": "running", "total": 2, "done": 1,
  "failed": 0, "credits_total": 0, "poll": "/api/v1/digest/batch/…",
  "items": [ … ] }

A link that could not be read is an item with status: error and an error_code; the rest of the batch is unaffected. Batches are kept for seven days.

Where the batch stands. Add ?include=digests to embed every finished digest, keyed by the url you sent.

curl "https://linkdigest.dev/api/v1/digest/batch/BATCH_ID?include=digests" \
  -H "Authorization: Bearer ld_live_..."
# 202 while links run, 200 when done

What this key’s account has left: plan, rolling window, credits used and remaining, pack credits, the key’s own monthly cap, and its webhook_secret. Starts nothing, costs nothing.

curl https://linkdigest.dev/api/v1/usage -H "Authorization: Bearer ld_live_..."

{ "plan": "dev", "unit": "credits",
  "period": { "window": "30d", "since": "…", "renewsAt": "…" },
  "used": 104, "limit": 500, "remaining": 646, "pack_credits": 250,
  "key": { "hint": "…", "monthly_cap": 30, "used": 13, "remaining": 17,
           "webhook_secret": "…" },
  "max_duration_seconds": 1800 }

Public, no key. For each platform: its state, an ok / degraded / unknown status, and when a real post on it was last read in full.

Webhooks

The webhook receives the same summary as the poll, as JSON, with two headers. Only https targets on public hosts are accepted. Delivery is at-least-once: a non-2xx answer is retried after 1 m, 5 m, 30 m and 2 h, five attempts in all.

The secret is in GET /api/v1/usage under key.webhook_secret; it is derived from the key and retires with it.

Verifying a delivery

// Node
const [t, v1] = sig.split(",").map((p) => p.split("=")[1]);
const expect = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
crypto.timingSafeEqual(Buffer.from(expect), Buffer.from(v1));

# Python
t, v1 = (p.split("=", 1)[1] for p in sig.split(","))
expect = hmac.new(secret.encode(), f"{t}.{raw_body}".encode(), "sha256").hexdigest()
hmac.compare_digest(expect, v1)

Response fields

Status codes

Limits

What LinkDigest will not do is on the platforms page, in writing: Bilibili answers HTTP 412 to our address, X long-form articles expose only their lead image, Instagram is wired but unverified. Anything that could not be read is named in degraded, and a digest that read nothing is not charged.