---
title: "開發者與 Agent 入口"
description: "數位引擎提供給開發者與 AI agent 的公開唯讀 API、Markdown、MCP、WebMCP 與 Agent Skills 入口。"
canonical: "https://www.darrenhuang.com/developers.html"
markdown: "https://www.darrenhuang.com/developers.md"
locale: "zh-hant"
language: "zh-Hant"
translationKey: null
type: website
---

> 此 Markdown 版本由正式 HTML 內容自動產生。
> 引用時請使用 [canonical page](https://www.darrenhuang.com/developers.html)。

Developer & Agent Portal

# 開發者與 Agent 入口

數位引擎提供給開發者與 AI agent 的公開唯讀 API、Markdown、MCP、WebMCP 與 Agent Skills 入口。

## 何時使用這個入口

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

## 快速開始

-   [內容索引](/api/content.json)提供文章與 Facebook 保存筆記的 metadata、canonical URL 和 Markdown URL。
-   [OpenAPI 3.1](/openapi.json)描述所有公開 JSON endpoints、參數、response schemas 與 typed errors。
-   [API Catalog](/.well-known/api-catalog)依 RFC 9727 列出 OpenAPI、內容 collections 與 MCP endpoint。
-   [MCP Server Card](/.well-known/mcp/server-card.json)描述不需要 authentication 的 stateless streamable HTTP MCP server。
-   [Agent Skill](/.well-known/agent-skills/research-digital-engine/SKILL.md)提供搜尋、判讀與引用本站內容的工作流程。
-   [Auth.md](/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、內容策略、自動化或網站體驗，可以前往[聯絡頁](/contact.html)。