# byrdocs-shortlink

URL 短链接服务。通过 REST 或 MCP 创建短链；相同链接自动去重（返回同一短码）；短链不可删除。

## 鉴权

创建类操作需在请求头携带 Bearer token（即 Worker 的 MCP_AUTH_TOKEN）：

    Authorization: Bearer <token>

跳转端点公开，无需鉴权。

## HTTP 端点

GET /<code>
  302 跳转到原始链接。公开。

POST /api/shorten
  创建短链。需鉴权。
  请求体: {"url": "https://example.com/long/path"}
  响应:   {"code","short_url","target_url","deduplicated"}
  错误:   401 token 无效/缺失；400 非法 JSON / 缺少 url / 非 http(s) 链接

示例:

    curl -X POST https://go.byrdocs.org/api/shorten \
      -H "Authorization: Bearer <token>" \
      -H "Content-Type: application/json" \
      -d '{"url":"https://example.com/long/path"}'

## MCP

端点:   https://go.byrdocs.org/mcp
传输:   Streamable HTTP
鉴权:   Authorization: Bearer <token>

工具:

create_short_link(url: string)
  为链接创建短链并返回短链 URL，相同链接自动去重。
  返回 structuredContent: {code, short_url, target_url, deduplicated}

lookup_short_link(url: string)
  查询链接是否已有短链；存在则返回，不创建新记录。
  返回 structuredContent: {found, code?, short_url?}

mcp-remote 接入示例:

    npx mcp-remote https://go.byrdocs.org/mcp --header "Authorization: Bearer <token>"

## 去重语义

对同一链接多次创建返回相同短码；响应中的 deduplicated 标记本次是否命中已有短链。