linkdigest-mcp 0.2.0__tar.gz

linkdigest_mcp-0.2.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+.pytest_cache/
+dist/
+build/

linkdigest_mcp-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LinkDigest
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

linkdigest_mcp-0.2.0/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.5
+Name: linkdigest-mcp
+Version: 0.2.0
+Summary: 抖音、小红书、TikTok、YouTube、X 链接转 AI 可读文本 — Python SDK, CLI and stdio MCP server for the hosted LinkDigest API
+Project-URL: Homepage, https://linkdigest.dev
+Project-URL: Documentation, https://github.com/jcaiagent7143-ui/linkdigest-mcp/blob/main/README.zh-CN.md
+Project-URL: Repository, https://github.com/jcaiagent7143-ui/linkdigest-mcp
+Project-URL: Issues, https://github.com/jcaiagent7143-ui/linkdigest-mcp/issues
+Author-email: LinkDigest <support@linkdigest.dev>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: douyin,mcp,mcp-server,ocr,rednote,tiktok,transcript,xiaohongshu,youtube,小红书,抖音,文案提取,爆款拆解
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Text Processing
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == 'test'
+Description-Content-Type: text/markdown
+
+# linkdigest-mcp (Python)
+
+<!-- mcp-name: dev.linkdigest/linkdigest -->
+
+把抖音、小红书、TikTok、YouTube、X 链接变成 AI 能读的文本：逐字稿、带大致时间的画面文字、
+每张图的描述和 OCR、要点，可选爆款拆解（breakdown）和翻译。
+
+Turn a Douyin, Xiaohongshu, TikTok, YouTube or X link into text an LLM can read.
+
+This package is a thin client for the hosted service at [linkdigest.dev](https://linkdigest.dev):
+nothing is downloaded or transcribed on your machine, and it has **no dependencies**
+(Python 3.10+, standard library only). It installs three things:
+
+| | |
+|---|---|
+| `from linkdigest import LinkDigest` | Python SDK — waits for long videos for you (`GET /api/v1/digest/{jobId}?wait=20`) and raises typed errors (402 carries a pay link) |
+| `linkdigest <url>` | command line — Markdown to stdout, `--json`, `--breakdown`, `--translate en` |
+| `linkdigest-mcp` | stdio MCP server — the `digest_url` tool, forwarded to `https://linkdigest.dev/mcp` with your key |
+
+Install from this repo (the package is **not on PyPI yet**; a `linkdigest-mcp` package on PyPI
+is not ours until this README says so):
+
+```bash
+pip install "git+https://github.com/jcaiagent7143-ui/linkdigest-mcp#subdirectory=python"
+```
+
+All three read the API key from `LINKDIGEST_API_KEY`. Issue one at
+[linkdigest.dev/app/keys](https://linkdigest.dev/app/keys) — 10 free credits on sign-up, no card.
+
+```python
+from linkdigest import LinkDigest
+
+ld = LinkDigest()  # LINKDIGEST_API_KEY
+d = ld.digest("https://v.douyin.com/xxxx/", breakdown=True)
+print(d.title, d.credits)
+print(d.markdown)
+```
+
+```bash
+linkdigest "https://xhslink.com/o/xxxx" --breakdown
+```
+
+```json
+{
+  "mcpServers": {
+    "linkdigest": {
+      "command": "uvx",
+      "args": ["--from", "git+https://github.com/jcaiagent7143-ui/linkdigest-mcp#subdirectory=python", "linkdigest-mcp"],
+      "env": { "LINKDIGEST_API_KEY": "ld_live_..." }
+    }
+  }
+}
+```
+
+Full documentation (中文): [README.zh-CN.md](https://github.com/jcaiagent7143-ui/linkdigest-mcp/blob/main/README.zh-CN.md)
+· English: [README.md](https://github.com/jcaiagent7143-ui/linkdigest-mcp/blob/main/README.md)
+
+MIT licensed.

linkdigest_mcp-0.2.0/README.md

@@ -0,0 +1,58 @@
+# linkdigest-mcp (Python)
+
+<!-- mcp-name: dev.linkdigest/linkdigest -->
+
+把抖音、小红书、TikTok、YouTube、X 链接变成 AI 能读的文本：逐字稿、带大致时间的画面文字、
+每张图的描述和 OCR、要点，可选爆款拆解（breakdown）和翻译。
+
+Turn a Douyin, Xiaohongshu, TikTok, YouTube or X link into text an LLM can read.
+
+This package is a thin client for the hosted service at [linkdigest.dev](https://linkdigest.dev):
+nothing is downloaded or transcribed on your machine, and it has **no dependencies**
+(Python 3.10+, standard library only). It installs three things:
+
+| | |
+|---|---|
+| `from linkdigest import LinkDigest` | Python SDK — waits for long videos for you (`GET /api/v1/digest/{jobId}?wait=20`) and raises typed errors (402 carries a pay link) |
+| `linkdigest <url>` | command line — Markdown to stdout, `--json`, `--breakdown`, `--translate en` |
+| `linkdigest-mcp` | stdio MCP server — the `digest_url` tool, forwarded to `https://linkdigest.dev/mcp` with your key |
+
+Install from this repo (the package is **not on PyPI yet**; a `linkdigest-mcp` package on PyPI
+is not ours until this README says so):
+
+```bash
+pip install "git+https://github.com/jcaiagent7143-ui/linkdigest-mcp#subdirectory=python"
+```
+
+All three read the API key from `LINKDIGEST_API_KEY`. Issue one at
+[linkdigest.dev/app/keys](https://linkdigest.dev/app/keys) — 10 free credits on sign-up, no card.
+
+```python
+from linkdigest import LinkDigest
+
+ld = LinkDigest()  # LINKDIGEST_API_KEY
+d = ld.digest("https://v.douyin.com/xxxx/", breakdown=True)
+print(d.title, d.credits)
+print(d.markdown)
+```
+
+```bash
+linkdigest "https://xhslink.com/o/xxxx" --breakdown
+```
+
+```json
+{
+  "mcpServers": {
+    "linkdigest": {
+      "command": "uvx",
+      "args": ["--from", "git+https://github.com/jcaiagent7143-ui/linkdigest-mcp#subdirectory=python", "linkdigest-mcp"],
+      "env": { "LINKDIGEST_API_KEY": "ld_live_..." }
+    }
+  }
+}
+```
+
+Full documentation (中文): [README.zh-CN.md](https://github.com/jcaiagent7143-ui/linkdigest-mcp/blob/main/README.zh-CN.md)
+· English: [README.md](https://github.com/jcaiagent7143-ui/linkdigest-mcp/blob/main/README.md)
+
+MIT licensed.

linkdigest_mcp-0.2.0/pyproject.toml

@@ -0,0 +1,80 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+# The distribution is `linkdigest-mcp` so that, once it is published on PyPI,
+# `uvx linkdigest-mcp` resolves to it. Until then install from git:
+#   uvx --from "git+https://github.com/jcaiagent7143-ui/linkdigest-mcp#subdirectory=python" linkdigest-mcp
+# The import package is `linkdigest` (`from linkdigest import LinkDigest`).
+name = "linkdigest-mcp"
+dynamic = ["version"]
+description = "抖音、小红书、TikTok、YouTube、X 链接转 AI 可读文本 — Python SDK, CLI and stdio MCP server for the hosted LinkDigest API"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "LinkDigest", email = "support@linkdigest.dev" }]
+# No runtime dependencies: HTTP is the standard library's urllib.
+dependencies = []
+keywords = [
+  "mcp",
+  "mcp-server",
+  "xiaohongshu",
+  "rednote",
+  "douyin",
+  "tiktok",
+  "youtube",
+  "transcript",
+  "ocr",
+  "小红书",
+  "抖音",
+  "文案提取",
+  "爆款拆解",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Natural Language :: Chinese (Simplified)",
+  "Natural Language :: English",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Internet :: WWW/HTTP",
+  "Topic :: Multimedia :: Video",
+  "Topic :: Text Processing",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://linkdigest.dev"
+Documentation = "https://github.com/jcaiagent7143-ui/linkdigest-mcp/blob/main/README.zh-CN.md"
+Repository = "https://github.com/jcaiagent7143-ui/linkdigest-mcp"
+Issues = "https://github.com/jcaiagent7143-ui/linkdigest-mcp/issues"
+
+[project.scripts]
+linkdigest = "linkdigest.cli:main"
+linkdigest-mcp = "linkdigest.mcp_server:main"
+
+[project.optional-dependencies]
+test = ["pytest>=7"]
+
+[tool.hatch.version]
+path = "src/linkdigest/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/linkdigest"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/linkdigest", "tests", "README.md", "LICENSE", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+  "live: calls the real https://linkdigest.dev/mcp — tools/list only, no API key, no credits. Skip offline with -m 'not live'.",
+]

linkdigest_mcp-0.2.0/src/linkdigest/__init__.py

@@ -0,0 +1,40 @@
+"""LinkDigest: social links (抖音, 小红书, TikTok, YouTube, X) as text an LLM can read.
+
+    from linkdigest import LinkDigest
+
+    ld = LinkDigest()  # reads LINKDIGEST_API_KEY; get one at https://linkdigest.dev/app/keys
+    d = ld.digest("https://v.douyin.com/xxxx/", breakdown=True)
+    print(d.title, d.credits)
+    print(d.markdown)
+
+Also installed: the `linkdigest` command line and the `linkdigest-mcp` stdio MCP server.
+"""
+
+from ._version import __version__
+from .client import Digest, LinkDigest
+from .errors import (
+    AuthenticationError,
+    InvalidRequestError,
+    JobPendingError,
+    LinkDigestError,
+    NetworkError,
+    PaymentRequiredError,
+    RateLimitError,
+    ServerError,
+    UnreadableLinkError,
+)
+
+__all__ = [
+    "__version__",
+    "LinkDigest",
+    "Digest",
+    "LinkDigestError",
+    "AuthenticationError",
+    "InvalidRequestError",
+    "JobPendingError",
+    "NetworkError",
+    "PaymentRequiredError",
+    "RateLimitError",
+    "ServerError",
+    "UnreadableLinkError",
+]

linkdigest_mcp-0.2.0/src/linkdigest/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+import sys
+
+sys.exit(main())

linkdigest_mcp-0.2.0/src/linkdigest/_http.py

@@ -0,0 +1,123 @@
+"""The one place this package touches the network.
+
+Everything else talks to a `Transport`: a callable that takes a `Request` and
+returns a `Response`. The default one is the standard library's urllib, so the
+package installs with no dependencies; tests pass a fake one instead.
+
+urllib honours HTTPS_PROXY / HTTP_PROXY / NO_PROXY from the environment, so a
+proxy works without configuration here.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import socket
+import ssl
+import urllib.error
+import urllib.request
+from dataclasses import dataclass, field
+from typing import Any, Callable, Dict, Optional
+
+from ._version import __version__
+from .errors import NetworkError
+
+USER_AGENT = f"linkdigest-python/{__version__} (+https://github.com/jcaiagent7143-ui/linkdigest-mcp)"
+
+
+@dataclass
+class Request:
+    method: str
+    url: str
+    headers: Dict[str, str] = field(default_factory=dict)
+    body: Optional[bytes] = None
+    timeout: float = 60.0
+
+
+@dataclass
+class Response:
+    status: int
+    # Header names are lower-cased so lookups do not depend on the server's casing.
+    headers: Dict[str, str] = field(default_factory=dict)
+    body: bytes = b""
+
+    @property
+    def text(self) -> str:
+        return self.body.decode("utf-8", errors="replace")
+
+    def json(self) -> Any:
+        return json.loads(self.body.decode("utf-8"))
+
+    def header(self, name: str, default: str = "") -> str:
+        return self.headers.get(name.lower(), default)
+
+
+Transport = Callable[[Request], Response]
+
+# Where operating systems keep their CA bundle, for a Python that ships without
+# one. The python.org installer on macOS is the common case: until "Install
+# Certificates.command" is run, every HTTPS request fails with
+# CERTIFICATE_VERIFY_FAILED, and urllib has no certifi to fall back on.
+_CA_BUNDLES = (
+    "/etc/ssl/cert.pem",  # macOS, Alpine, Arch
+    "/etc/ssl/certs/ca-certificates.crt",  # Debian, Ubuntu
+    "/etc/pki/tls/certs/ca-bundle.crt",  # Fedora, RHEL
+    "/etc/ssl/ca-bundle.pem",  # openSUSE
+    "/opt/homebrew/etc/ca-certificates/cert.pem",
+    "/usr/local/etc/ca-certificates/cert.pem",
+)
+_ssl_context: Optional[ssl.SSLContext] = None
+
+
+def ssl_context() -> ssl.SSLContext:
+    """The default verifying context, plus a CA bundle if Python found none of its own."""
+    global _ssl_context
+    if _ssl_context is None:
+        ctx = ssl.create_default_context()
+        if not ctx.cert_store_stats().get("x509_ca"):
+            candidates = []
+            try:
+                import certifi  # type: ignore[import-not-found]  # optional, used when present
+
+                candidates.append(certifi.where())
+            except ImportError:
+                pass
+            candidates.extend(_CA_BUNDLES)
+            for path in candidates:
+                if os.path.isfile(path):
+                    try:
+                        ctx.load_verify_locations(cafile=path)
+                        break
+                    except (OSError, ssl.SSLError):
+                        continue
+        _ssl_context = ctx
+    return _ssl_context
+
+
+def urllib_transport(req: Request) -> Response:
+    """Send one request with urllib. 4xx/5xx are returned, not raised."""
+    headers = {"User-Agent": USER_AGENT, **req.headers}
+    r = urllib.request.Request(req.url, data=req.body, headers=headers, method=req.method)
+    try:
+        context = ssl_context() if req.url.startswith("https:") else None
+        with urllib.request.urlopen(r, timeout=req.timeout, context=context) as resp:
+            return Response(
+                status=resp.status,
+                headers={k.lower(): v for k, v in resp.headers.items()},
+                body=resp.read(),
+            )
+    except urllib.error.HTTPError as e:
+        # An HTTP error status is an answer from the server, not a failure to
+        # reach it: hand it back so the caller can read the JSON error body.
+        try:
+            body = e.read()
+        except OSError:
+            body = b""
+        return Response(
+            status=e.code,
+            headers={k.lower(): v for k, v in (e.headers or {}).items()},
+            body=body,
+        )
+    except (urllib.error.URLError, socket.timeout, TimeoutError, ConnectionError, OSError) as e:
+        reason = getattr(e, "reason", None) or e
+        raise NetworkError(f"could not reach {req.url}: {reason}") from e

linkdigest_mcp-0.2.0/src/linkdigest/_version.py

@@ -0,0 +1 @@
+__version__ = "0.2.0"

linkdigest_mcp-0.2.0/src/linkdigest/cli.py

@@ -0,0 +1,144 @@
+"""linkdigest — read a social link from the terminal.
+
+    export LINKDIGEST_API_KEY=ld_live_...
+    linkdigest "https://v.douyin.com/xxxx/"                 # Markdown to stdout
+    linkdigest "https://xhslink.com/o/xxxx" --breakdown     # + 爆款拆解 (+1 credit)
+    linkdigest "<link>" --translate en --json > post.json   # structured JSON
+    pbpaste | linkdigest -                                  # the whole share text works too
+    linkdigest --job <job_id>                               # collect a job that was still running
+
+Status (credits spent, cache hits, a job still running) goes to stderr, so
+stdout stays clean for pipes.
+
+Exit codes: 0 ok · 1 error · 2 usage or no key · 3 out of credits (prints the
+pay link) · 4 still running after --max-wait (prints the job id).
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from typing import List, Optional, TextIO
+
+from ._version import __version__
+from .client import API_KEY_ENV, DEFAULT_MAX_WAIT, LinkDigest
+from .errors import (
+    KEYS_URL,
+    AuthenticationError,
+    JobPendingError,
+    LinkDigestError,
+    PaymentRequiredError,
+)
+
+EXIT_OK, EXIT_ERROR, EXIT_USAGE, EXIT_PAYMENT, EXIT_PENDING = 0, 1, 2, 3, 4
+
+
+def _parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(
+        prog="linkdigest",
+        description=(
+            "Turn a Xiaohongshu, Douyin, TikTok, YouTube or X link into text: transcript, "
+            "on-screen text, image descriptions and OCR, key points; optionally a viral "
+            "breakdown (爆款拆解) and a translation. Uses the hosted API at linkdigest.dev "
+            f"with the key in ${API_KEY_ENV}."
+        ),
+        epilog=f"Get a key: {KEYS_URL}",
+    )
+    p.add_argument("url", nargs="?", help="the link, or the whole share text containing it; '-' reads stdin")
+    p.add_argument("--breakdown", action="store_true", help="also take the post apart: hook, timed beats, template (+1 credit)")
+    p.add_argument("--translate", metavar="LANG", help="also translate, e.g. en, ja, zh-CN (+1 credit)")
+    p.add_argument("--json", action="store_true", help="print the full JSON instead of Markdown")
+    p.add_argument("--partial-ok", action="store_true", help="read the opening minutes of a video that is too long, instead of refusing it")
+    p.add_argument("--depth", choices=["full", "transcript"], default="full", help="transcript = a long video in full as a transcript, 1 credit per 2 minutes (not YouTube)")
+    p.add_argument("--max-credits", type=int, metavar="N", help="refuse (free of charge) if this link would cost more than N credits")
+    p.add_argument("--job", metavar="JOB_ID", help="collect a digest that was still running, instead of reading a url")
+    p.add_argument("--max-wait", type=float, default=DEFAULT_MAX_WAIT, metavar="SECONDS", help=f"how long to wait for a long job (default {DEFAULT_MAX_WAIT:.0f})")
+    p.add_argument("--check-key", action="store_true", help="validate the API key without spending a credit, then exit")
+    p.add_argument("--api-key", help=f"API key (default: ${API_KEY_ENV}; prefer the env var, arguments show up in shell history)")
+    p.add_argument("--base-url", help="API base URL (default https://linkdigest.dev)")
+    p.add_argument("-q", "--quiet", action="store_true", help="no status lines on stderr")
+    p.add_argument("--version", action="version", version=f"linkdigest {__version__}")
+    return p
+
+
+def _utf8(stream: TextIO) -> None:
+    """Chinese text must survive a Windows pipe (cp936 / cp1252)."""
+    enc = (getattr(stream, "encoding", "") or "").lower().replace("-", "")
+    if enc != "utf8" and hasattr(stream, "reconfigure"):
+        try:
+            stream.reconfigure(encoding="utf-8", errors="replace")
+        except (ValueError, OSError):
+            pass
+
+
+def main(argv: Optional[List[str]] = None, stdin: Optional[TextIO] = None) -> int:
+    args = _parser().parse_args(argv)
+    out, err = sys.stdout, sys.stderr
+    _utf8(out)
+
+    def status(line: str) -> None:
+        if not args.quiet:
+            print(line, file=err, flush=True)
+
+    url = args.url
+    if url == "-":
+        url = (stdin or sys.stdin).read()
+    if not args.check_key and not args.job and not (url and url.strip()):
+        _parser().print_usage(err)
+        print("linkdigest: give a link (or '-' to read one from stdin), or --job JOB_ID", file=err)
+        return EXIT_USAGE
+
+    try:
+        client = LinkDigest(args.api_key, base_url=args.base_url, max_wait=args.max_wait)
+    except AuthenticationError as e:
+        print(f"linkdigest: {e}", file=err)
+        return EXIT_USAGE
+
+    def on_pending(job_id: str, stage: Optional[str]) -> None:
+        status(f"… still reading (job {job_id}{', ' + stage if stage else ''})")
+
+    fmt = "json"  # always ask for JSON: it carries credits and cached, and raw_markdown
+    try:
+        if args.check_key:
+            info = client.check_key()
+            key = info.get("key") or {}
+            print(f"key ok: {key.get('label') or ''} {key.get('hint') or ''}".rstrip(), file=out)
+            return EXIT_OK
+        if args.job:
+            digest = client.collect(args.job, fmt, on_pending=on_pending)
+        else:
+            digest = client.digest(
+                url,
+                fmt,
+                breakdown=args.breakdown,
+                translate_to=args.translate,
+                partial_ok=args.partial_ok,
+                depth=args.depth,
+                max_credits=args.max_credits,
+                on_pending=on_pending,
+            )
+    except PaymentRequiredError as e:
+        print(f"linkdigest: {e}", file=err)
+        return EXIT_PAYMENT
+    except JobPendingError as e:
+        print(f"linkdigest: {e}", file=err)
+        print(f"collect it with: linkdigest --job {e.job_id}", file=err)
+        return EXIT_PENDING
+    except LinkDigestError as e:
+        print(f"linkdigest: {e}", file=err)
+        return EXIT_ERROR
+
+    if args.json:
+        print(json.dumps(digest.data, ensure_ascii=False, indent=2), file=out)
+    else:
+        print(digest.markdown.rstrip("\n"), file=out)
+    cost = "cached, 0 credits" if digest.cached else f"{digest.credits} credit(s)"
+    status("[linkdigest] " + " · ".join(p for p in (digest.platform, cost) if p))
+    for note in digest.degraded:
+        status(f"[linkdigest] degraded: {note}")
+    return EXIT_OK
+
+
+if __name__ == "__main__":  # pragma: no cover
+    sys.exit(main())