运行时依赖
安装命令
点击复制技能文档
阿里云ICP备案成功数据查询场景说明 完成阿里云ICP备案(备案)后,客户需要:
- 登录备案系统查看备案成功信息
- 查询备案详情,包括主体、网站、APP信息
- 检查备案是否存在需关注的风险
本技能通过阿里云API自动查询ICP备案成功数据及关联风险信息。
架构: 阿里云备案服务 → QuerySuccessIcpData API → 备案信息(主体+网站+APP+风险)
安装
阿里云CLI
本技能要求Aliyun CLI ≥3.3.3。
预检:需Aliyun CLI ≥3.3.3
运行 aliyun version 验证版本。
未安装或版本过低,执行:
curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash
或参考 references/cli-installation-guide.md
预检:必须更新CLI插件
- 必须运行
aliyun configure set --auto-plugin-install true启用自动插件安装 - 必须运行
aliyun plugin update保持插件最新
Python依赖
当前插件版本尚未支持对应CLI命令,本技能使用Python Common SDK:
pip install -r scripts/requirements.txt
认证 预检:需阿里云凭证 安全规则:
- 禁止读取、回显或打印AK/SK(如
echo $ALIBABA_CLOUD_ACCESS_KEY_ID) - 禁止在对话或命令行直接让用户输入AK/SK
- 禁止使用
aliyun configure set直接写入凭证明文 - 仅使用
aliyun configure list检查凭证状态
aliyun configure list
查看输出是否含有效profile(AK、STS或OAuth身份)。
若无有效profile,请停止操作。
获取凭证:
在阿里云控制台配置,或通过终端aliyun configure、shell环境变量设置。
配置完成后重新运行aliyun configure list确认有效profile。
RAM策略
本技能需beian:QuerySuccessIcpData权限。
完整RAM策略JSON及配置见 references/ram-policies.md。
权限失败处理: 任何命令或API因权限错误失败时:
- 读取 references/ram-policies.md 获取所需权限列表
- 使用 ram-permission-diagnose 技能引导用户申请权限
- 暂停并等待用户确认权限已授予
参数确认 重要:执行任何命令或API前,必须向用户确认所有可自定义参数(如RegionId、实例名、CIDR、密码、域名、资源规格等)。 禁止擅自使用默认值。
参数说明:
- Caller:必填,API请求调用方标识,固定值"skill"
- Region:可选,阿里云地域,默认cn-hangzhou
核心流程 启动核心流程前(任何CLI调用前): 必须启用AI-Mode:
aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-icpba-sucessdata-query"
步骤1:查询ICP备案成功数据
当前插件版本尚未支持aliyun companyreg query-success-icp-data命令,使用Python Common SDK直接调用API。
创建Python脚本查询备案数据:
#!/usr/bin/env python3 # -- coding: utf-8 -- from alibabacloud_credentials.client import Client as CredentialClient from alibabacloud_tea_openapi.client import Client as OpenApiClient from alibabacloud_tea_openapi import models as open_api_models from alibabacloud_tea_util import models as util_models import jsondef create_client() -> OpenApiClient: credential = CredentialClient() config = open_api_models.Config( credential=credential, endpoint='companyreg.aliyuncs.com', region_id='cn-hangzhou', user_agent='AlibabaCloud-Agent-Skills/alibabacloud-icpba-sucessdata-query' ) return OpenApiClient(config)
def query_success_icp_data(caller: str = 'skill') -> dict: client = create_client() params = open_api_models.Params( action='Query