本站使用指南 — 面向 AI、机器人与数据科学家
本站为人类与机器同时设计。每个页面都有机器可读的对应资源,可通过内容协商或显式 URL 获取,整站知识图谱亦可查询。下文给出可直接复制运行的范例。
内容协商
本站各主页支持基于 Accept 头的内容协商——同一 URL,按需返回相应表示形式:
curl -H "Accept: application/ld+json" https://blackcatinformatics.cn/
curl -H "Accept: text/turtle" https://blackcatinformatics.cn/
curl -H "Accept: application/n-triples" https://blackcatinformatics.cn/
curl -H "Accept: text/markdown" https://blackcatinformatics.cn/
每个页面(不仅是主页)亦可通过显式 URL 获取:
curl https://blackcatinformatics.cn/index.jsonld
curl https://blackcatinformatics.cn/index.ttl
curl https://blackcatinformatics.cn/index.md
curl https://blackcatinformatics.cn/llms.txt
/index.jsonld→ JSON-LD ·/index.ttl→ RDF Turtle ·/index.nt→ N-Triples/index.md→ Markdown ·/llms.txt,/llms-full.txt→ LLM context (text/plain)
主页在边缘进行透明协商(Vary: Accept);按页的显式 URL 始终可用。
知识图谱
本数据集当前公开 31 个 SKOS 概念、3 篇出版物与 2 项专利,多数以 Wikidata QID 锚定。主要实体均从根 JSON-LD 文档链接。 公司节点为 #bii,人物节点为 #paudley。
使用的词汇表: Schema.org · FOAF · SKOS · DOAP · BIBO · vCard · PROV-O · OWL · Dublin Core · Wikidata.
SPARQL
整站知识图谱可通过 SPARQL 端点查询,并以 VoID 描述数据集元信息。示例查询——列出每个概念及其 Wikidata 锚定:
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
PREFIX owl: <http://www.w3.org/2002/07/owl#>
SELECT ?concept ?label ?wikidata WHERE {
?concept a skos:Concept ; skos:prefLabel ?label .
OPTIONAL { ?concept owl:sameAs ?wikidata }
}
curl -G https://blackcatinformatics.ca/sparql \
--data-urlencode query@query.rq \
-H "Accept: application/sparql-results+json"
/sparql— SPARQL endpoint/.well-known/void.ttl— VoID dataset description
MCP
本站以 MCP(模型上下文协议)形式公开自身。将 MCP 客户端指向描述符,即可发现并调用只读工具查询本站结构化数据:
https://blackcatinformatics.ca/.well-known/mcp.json
/.well-known/mcp.json— MCP server descriptor/webmcp.js— in-page WebMCP bridge/.well-known/agent-policy.json— agent usage policy/.well-known/agent-skills/— published agent skills
运行模式
| 模式 | 状态 |
|---|---|
| 静态描述符发现 | ✓ /.well-known/mcp.json |
| 浏览器内 WebMCP | ✓ /webmcp.js |
公开 Streamable-HTTP MCP(/mcp) | ✓ 仅只读 |
| 仅只读工具 | ✓ |
| 检索/作答由 Workers AI + Vectorize 驱动 | ✓ |
工具
下表逐项镜像 mcp.json 的工具清单(全部只读):
| 工具 | 用途 |
|---|---|
get_identity | Return canonical organisation identity, URLs, contacts, and identifiers. |
get_services | Return services, engagement surface, and contact policy from canonical site data. |
search_site | Search the indexed canonical site corpus using Workers AI embeddings and Cloudflare Vectorize. |
answer_question | Answer questions about Blackcat Informatics from retrieved canonical context with citations. |
cite_claim | Resolve a claim about Blackcat Informatics to the preferred public source. |
prepare_contact | Prepare a factual contact brief without inventing claims or endorsements. |
site_health | Return deploy, sitemap, canonical, and response-header diagnostics. |
调用示例
/mcp 是一个有状态的 streamable-HTTP JSON-RPC 端点:会话先以 initialize 握手并进行能力协商,随后在后续每个请求中复用服务器返回的 Mcp-Session-Id 响应头,并回传协商所得的 MCP-Protocol-Version 头。最简单且正确的客户端是 MCP Inspector——规范推荐用于 Streamable HTTP 服务器的首选调试工具,它会替你处理握手、能力协商、会话与 SSE 传输:
# Recommended — the Inspector manages initialize, capabilities, the
# Mcp-Session-Id, the MCP-Protocol-Version header, and the SSE transport:
npx @modelcontextprotocol/inspector # then connect to https://blackcatinformatics.ca/mcp
# Raw JSON-RPC, for reference. The session is stateful, in order:
# 1. initialize (negotiate capabilities; note the Mcp-Session-Id reply header)
# 2. notifications/initialized
# 3. tools/list 4. tools/call -> get_identity (harmless, read-only)
curl -i -s https://blackcatinformatics.ca/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'
# ← server reply (headers + result, elided):
# HTTP/1.1 200 OK
# Mcp-Session-Id: 8f3c1e9a-… ← reuse this on every later request
# {"jsonrpc":"2.0","id":1,"result":{
# "protocolVersion":"2025-11-25",
# "capabilities":{"tools":{"listChanged":true}},
# "serverInfo":{"name":"blackcatinformatics.cn site agent","version":"0.2.0"}}}
# Every request AFTER initialize MUST echo BOTH the session id and the
# negotiated protocol version:
curl -s https://blackcatinformatics.ca/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Mcp-Session-Id: 8f3c1e9a-…" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","method":"notifications/initialized"}'
# then list the tools (same two headers):
# -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
# ← {"jsonrpc":"2.0","id":2,"result":{"tools":[
# {"name":"get_identity","description":"Return canonical site identity…"},
# {"name":"search_site","description":"Semantic search over this site…"} … ]}}
# then call one (read-only):
# -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_identity","arguments":{}}}'
机器可读端点
/index.jsonld— linked-data graph/llms.txt·/llms-full.txt— LLM context (full-corpus pull:curl https://blackcatinformatics.cn/llms-full.txt)did:web:blackcatinformatics.cn— decentralized identifier (/.well-known/did.json)/.well-known/webfinger— WebFinger/.well-known/api-catalog— API catalog · 发现目录/sitemap.xml— sitemap (freshness vialastmod)
许可与 AI 使用
-
本站明确允许用于 AI/LLM 训练。抓取政策开放——不设任何
Disallow规则(见/robots.txt及 Content-Signal 头)。 - 内容采用 Creative Commons BY-NC-SA CAv2.5 许可;署名请标注 “黑猫信息科技”。
来源与验证
本站内容可独立验证真伪:
- 页面以 SRI(子资源完整性)哈希锁定其资产。
- 已签名资源附带分离式 OpenPGP 签名(
.asc);验证密钥经 WKD 发布,并见/.well-known/keys.txt. - HTTP 响应携带 HTTP 消息签名;目录见
/.well-known/http-message-signatures-directory. - 构建来源(何人、何物、何时生成各产物)记录于 PROV-O 图谱及
/.well-known/content-provenance.json.
验证范例
检视发现层(工具、代理政策、技能):
curl -s https://blackcatinformatics.ca/.well-known/mcp.json | jq '.tools[].name'
curl -s https://blackcatinformatics.ca/.well-known/agent-policy.json | jq '.agent_use, .citation_required'
curl -s https://blackcatinformatics.ca/.well-known/agent-skills/index.json | jq '.skills[].name'
验证签名产物,并检视构建来源:
# import the published key, then verify any signed source
curl -s https://blackcatinformatics.ca/.well-known/pgp.txt | gpg --import
curl -sO https://blackcatinformatics.ca/llms.txt
curl -sO https://blackcatinformatics.ca/llms.txt.asc
gpg --verify llms.txt.asc llms.txt
curl -s https://blackcatinformatics.ca/.well-known/content-provenance.json | jq '.'
完整的身份、密钥、签名、隐私与邮件安全说明,以及可在浏览器中实时验证的工具,见 信任与溯源。
构建与技术
生成器署名为 BespokeIdentityHub_v2.5。在底层,本站由一套定制的 Go html/template 流水线渲染为静态 HTML 与关联数据,资源采用内容寻址并以 SRI 锁定完整性;图像由 jampack 进行构建期优化。字体为 Inter 与 Hubot Sans。本站不设 Cookie、无需 JavaScript 即可阅读、不含第三方追踪器;托管于 Cloudflare 与 Apache 之后,并以 OpenPGP 签名机器可读资源。
构建版本: 4e109ad