開發者與 Agent 入口

何時使用這個入口

當你要研究數位引擎的 SEO、數位行銷、內容策略、網站分析、AI 或自動化文章時，請先從這個入口或llms.txt開始。 這裡的介面適合需要搜尋公開內容、取得文章 metadata、讀取 Markdown，或在支援的瀏覽器中使用 WebMCP 的 agent。 所有內容都是公開唯讀資料，不需要登入、API key、帳號或瀏覽器 JavaScript。

快速開始

• 內容索引提供文章與 Facebook 保存筆記的 metadata、canonical URL 和 Markdown URL。
• OpenAPI 3.1描述所有公開 JSON endpoints、參數、response schemas 與 typed errors。
• API Catalog依 RFC 9727 列出 OpenAPI、內容 collections 與 MCP endpoint。
• MCP Server Card描述不需要 authentication 的 stateless streamable HTTP MCP server。
• Agent Skill提供搜尋、判讀與引用本站內容的工作流程。
• Auth.md說明本站為什麼不需要註冊、token 或 credential。

REST API 與版本政策

目前穩定版本是 version 1。 API client 可以省略 header 以使用目前版本，也可以送出X-API-Version: 1 明確選擇 version 1。 成功與錯誤 response 都會回傳X-API-Version: 1。

未來若需要不相容的變更，會發布新的版本並保留既有版本一段合理的遷移期間。 任何即將淘汰的 endpoint 都會以 Deprecation 與Sunset response headers，以及本頁和 OpenAPI description 公告。 目前沒有 endpoint 被淘汰。

GET /api/content.json
Accept: application/json
X-API-Version: 1

錯誤處理

API 錯誤會使用 HTTP status code 和 JSON body，不會把 HTML app shell 當成 API response。 錯誤 body 會包含機器可讀的 code、人類可讀的message，以及可協助恢復的 hint。

{
  "error": {
    "code": "not_found",
    "message": "The requested public content item was not found.",
    "hint": "Use /api/content.json to discover valid article and note slugs."
  }
}

MCP 與 WebMCP

MCP endpoint 位於 /mcp，支援initialize、ping、tools/list 與tools/call。 它只提供 search_content 與 read_content 兩個唯讀工具，不支援登入、購買、寫入、刪除或代表使用者操作。

支援 WebMCP 的瀏覽器可以直接使用頁面上的 digital_engine_search_content 與 digital_engine_read_content 兩個唯讀工具。這些站點專屬名稱可與 MCP HTTP endpoint 的 search_content、read_content 清楚區分。不支援 WebMCP 的 client 仍可使用 Markdown、JSON API 或 MCP HTTP endpoint。

範圍與限制

數位引擎是公開內容 archive，不是 SaaS product 或交易平台。 本站沒有 API key 發放、sandbox、帳號管理、付款、訂單、留言或寫入 API。 文章中的歷史介面、政策、產品功能與外部連結可能已改變；涉及目前狀態的問題應再查閱相關服務的最新一手來源。

如需討論 SEO、AI、內容策略、自動化或網站體驗，可以前往聯絡頁。