短链接 - 即刻数据

短链接。支持生成短链接、短链接还原和短链接访问统计，可设置最大访问次数和到期时间。适用场景：用户说“帮我生成一个短链接”“还原这个短链跳到哪里”“查一下这个短链访问次数”等。数据由即刻数据（jikeapi.cn）开放接口提供。

Security Scan

该技能的声明、所需依赖和脚本行为在逻辑上是一致的：它需要一个即刻数据的 AppKey 并调用即刻数据的短链接 API，未发现与其描述明显不符的权限或隐藏后门。

Purpose & Capability

技能名称/描述为短链接服务，要求 python3 和 一个 JIKE_SHORTLINK_KEY（或 JIKE_APPKEY）作为主凭据，与脚本中调用短链 create/restore/stat 接口的行为一致。没有要求与短链接功能不相关的凭据或二进制。

Instruction Scope

SKILL.md 指导运行脚本并设置 AppKey，脚本实现也仅执行 URL 参数校验并向即刻数据 API 发起 HTTP 请求，范围与目的相符。需注意脚本会（1）尝试从脚本目录的 .env 读取 AppKey，且（2）支持通过环境变量 JIKE_API_BASE_URL 覆盖默认 API 主机——这两点在 SKILL.md 中没被充分突出，可能导致请求被重定向到非官方主机（用于测试是有用的，但在不受信环境下存在风险）。

Install Mechanism

无安装规范（instruction-only + 附带脚本），不会自动下载或写入新二进制；仅要求系统上存在 python3，安装风险低。

Credentials

所需的主要凭据仅为 JIKE_SHORTLINK_KEY（或 JIKE_APPKEY），与短链接服务相称。但脚本还使用未在 requires.env 列出的环境变量 JIKE_API_BASE_URL（可重定向 API 目标），以及将 appkey 作为 URL 查询参数发送（易被代理/服务器日志记录、可能泄露），这些实现细节应被用户注意。

Persistence & Privilege

技能没有请求长期驻留（always=false），也不修改其他技能或系统配置，权限边界清晰。

Assessment

总体上该技能在功能与所需权限上是一致的；在决定安装/使用前请注意： - 仅向你信任的服务（https://api.jikeapi.cn 或官网）提供 AppKey，避免在不可信环境中设置凭据。 - 脚本会把 appkey 放入 URL 查询参数（appkey=...），这可能被代理或服务器日志记录，敏感场景下应避免或使用可收回的低权限/临时 Key。 - 脚本支持用环境变量 JIKE_API_BASE_URL 覆盖默认 API 主机，确认未被他人设置或篡改以防请求被重定向到非官方服务。 - 如果你担心泄露，可在受控环境先手动运行并审阅 scripts/shortlink.py 源码，或把 key 通过命令行临时传入 (--key) 并在使用后撤销。 如果你希望更高保障，建议联系即刻数据官方确认 AppKey 的权限边界或要求 API 支持通过 Authorization header 发送凭据以避免在 URL 中暴露。

数据由 即刻数据 提供。即刻数据专注稳定易用的数据 API、MCP 与 AI Skill 能力，帮助开发者和 AI 客户端快速接入可靠数据服务。

支持：生成短链接、短链接还原、短链接访问统计。

---

前置配置：获取 AppKey

export JIKE_SHORTLINK_KEY=你的AppKey

也可以使用通用 Key：

export JIKE_APPKEY=你的AppKey

---

使用方法

生成短链接

python3 scripts/shortlink.py create --target https://www.jikeapi.cn/

可设置访问次数和到期时间：

python3 scripts/shortlink.py create --target https://www.jikeapi.cn/ --max-access-count 100 --expiration-time "2026-11-13 12:44:00"

短链接还原

python3 scripts/shortlink.py restore --link http://t.jikeapi.cn/s/NgZYJ

访问统计

python3 scripts/shortlink.py stat --link http://t.jikeapi.cn/s/NgZYJ

指定统计时间范围：

python3 scripts/shortlink.py stat --link http://t.jikeapi.cn/s/NgZYJ --start-time "2025-10-01 00:00:00" --end-time "2025-10-01 14:29:59"

直接调用 API

GET https://api.jikeapi.cn/v1/shortlink/create?target=https://www.jikeapi.cn/&appkey=YOUR_APPKEY
GET https://api.jikeapi.cn/v1/shortlink/restore?link=http://t.jikeapi.cn/s/NgZYJ&appkey=YOUR_APPKEY
GET https://api.jikeapi.cn/v1/shortlink/stat?link=http://t.jikeapi.cn/s/NgZYJ&appkey=YOUR_APPKEY

---

AI 使用步骤

当用户要求生成、还原或统计短链接时：

1. 判断动作：生成用 create；还原用 restore；访问统计用 stat。
2. 提取链接：生成时提取原始 URL；还原/统计时提取短链 URL。
3. 确认限制：生成短链属于写操作，涉及真实创建短链；如果用户没有明确目标链接，应先询问。
4. 调用脚本：执行对应子命令。
5. 展示结果：生成时返回短链、到期时间、最大访问数；统计时返回访问次数和 IP 数。

参数说明

子命令	参数	说明
create	--target	原始地址，必须为国内已备案地址
create	--max-access-count	最大访问次数，不传代表不限制
create	--expiration-time	到期时间，格式 YYYY-mm-dd HH:MM:SS
restore	--link	短链接
stat	--link	短链接
stat	--start-time、--end-time	统计起止时间，需同时传入

返回字段

字段	含义
target	原始链接
link	短链地址
simple_link	不带协议的短链地址
expiration_time	到期时间
max_access_count	最大访问次数，0 表示不限次
access_count	总访问次数
ip_count	IP 数量

错误处理

情况	处理方式
未配置 AppKey	提醒用户配置 JIKE_SHORTLINK_KEY 或 JIKE_APPKEY
链接格式错误	提醒用户提供 http 或 https 链接
起止时间只传一个	提醒用户同时传入 start-time 和 end-time
原始地址未备案	展示接口返回 message
网络超时	建议稍后重试或检查网络

---

脚本位置

scripts/shortlink.py：封装了 create、restore、stat 三个短链接接口的参数校验、请求和展示逻辑。