51domino Site API
51domino 技术博客与解决方案的公开检索接口。
Public, read-only search API. All public endpoints require no credentials.
Machine-readable spec: /openapi.json ·
Catalog: /.well-known/api-catalog ·
Agent policy: /auth.md
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/search?q=关键词 |
Search blog posts and solution pages. Returns JSON array of {slug,title,category,date,excerpt}. Chinese and English queries both work. |
| GET | /api/tweets |
Cached AI industry tweet feed (updated_at + tweets[]). |
| POST | /api/contact |
Project enquiry intake. JSON body: name (required), email (required), company, message. Rate limit: 1 request / minute / IP. |
| GET | /health |
Service status JSON. |
Example
curl -s "https://www.51domino.com/api/search?q=RAG" | head
MCP endpoint
An MCP (Model Context Protocol) server is exposed over Streamable HTTP at
/mcp with these tools:
| Tool | What it does |
|---|---|
search_articles | Search the Chinese AI/LLM technical blog and solution library. |
get_article | Fetch the full markdown body of one article by slug. |
list_products | List 51domino enterprise AI products with URLs and summaries. |
get_company_info | Company profile, contact channels and key resources. |
export_article_index | Protected — bulk export of the whole article index. Requires an OAuth 2.0 bearer token with scope content:export (see below). |
curl -s https://www.51domino.com/mcp -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Server card: /.well-known/mcp/server-card.json
Agent authentication (OAuth 2.0)
Public tools need no credentials. For the protected export tool, register an anonymous client (no account, no email) and mint a token:
curl -s -X POST https://www.51domino.com/oauth/register \
-H 'Content-Type: application/json' \
-d '{"client_name":"my-agent","grant_types":["client_credentials"],"scope":"content:export"}'
curl -s -X POST https://www.51domino.com/oauth/token \
-d 'grant_type=client_credentials&client_id=…&client_secret=…&scope=content:export'
Metadata: /.well-known/oauth-protected-resource · /.well-known/oauth-authorization-server · /oauth/jwks.json · policy: auth.md
Markdown for agents
Every HTML page can be fetched as markdown:
curl -s https://www.51domino.com/ -H 'Accept: text/markdown'