【开发小技巧】手把手调用腾讯 ClawHub 镜像分页搜索接口

【开发小技巧】手把手调用腾讯 ClawHub 镜像分页搜索接口一、接口简介如果你想在自己的项目里快速实现「技能列表检索」能力这个接口非常适合做数据源。接口地址https://lightmake.site/api/skills请求方式GET功能说明分页搜索 skill支持关键词筛选、排序字段和排序方向认证方式文档中未要求认证可直接调用二、请求参数说明参数名位置类型是否必填说明pagequerystring否页码如1pageSizequerystring否每页条数如10keywordquerystring否关键词搜索可匹配名称/描述等sortByquerystring否排序字段updated_at/downloads/stars/installs/scoreorderquerystring否排序方向asc/desc三、最小可用调用示例推荐先跑通1curl 方式curlhttps://lightmake.site/api/skills?page1pageSize10keywordagentsortByupdated_atorderdesc2浏览器直接访问将下面 URL 粘贴到浏览器地址栏即可看到 JSON 返回https://lightmake.site/api/skills?page1pageSize10keywordagentsortByupdated_atorderdesc四、Python 调用示例requestsimportrequests urlhttps://lightmake.site/api/skillsparams{page:1,pageSize:10,keyword:agent,sortBy:updated_at,order:desc}resprequests.get(url,paramsparams,timeout10)resp.raise_for_status()dataresp.json()ifdata.get(code)0:skillsdata.get(data,{}).get(skills,[])totaldata.get(data,{}).get(total,0)print(f总数:{total}当前返回:{len(skills)})foriteminskills:print(f-{item.get(name)}| downloads{item.get(downloads)}| updated_at{item.get(updated_at)})else:print(接口返回异常,data.get(message))五、JavaScript 调用示例fetchconstbaseUrlhttps://lightmake.site/api/skills;constparamsnewURLSearchParams({page:1,pageSize:10,keyword:agent,sortBy:score,order:desc});fetch(${baseUrl}?${params.toString()}).then(res{if(!res.ok)thrownewError(HTTP${res.status});returnres.json();}).then(data{if(data.code0){constskillsdata.data?.skills||[];console.log(total ,data.data?.total);skills.forEach(item{console.log(${item.name}| score${item.score});});}else{console.error(业务错误,data.message);}}).catch(err{console.error(请求失败,err.message);});六、返回结构解读接口成功时通常返回{code:0,data:{skills:[{name:AOI Council,slug:aoi-council,category:developer-tools,description:...,description_zh:...,downloads:555,installs:6,stars:0,score:99640.93,ownerName:edmonddantesj,homepage:https://clawhub.ai/...,version:0.1.2,created_at:1772775811536,updated_at:1775374570711}],total:32958},message:success}你在业务中最常用的字段一般是data.skills当前页列表data.total总条数用于前端分页code业务状态0表示成功message提示信息七、实战建议避免踩坑参数类型统一用字符串传递文档里参数类型都是string建议客户端保持一致。分页要做边界保护当skills为空时通常表示页码过大或关键词无结果。排序字段做白名单校验后端支持固定值updated_at/downloads/stars/installs/score前端不要随意拼接。加上超时与重试机制生产环境建议设置请求超时如 5~10 秒并做有限重试。八、可直接复用的查询模板GET https://lightmake.site/api/skills?page{page}pageSize{pageSize}keyword{keyword}sortBy{sortBy}order{order}示例https://lightmake.site/api/skills?page2pageSize20keywordweb3sortBydownloadsorderdesc九、总结通过这一个接口你可以快速实现技能市场列表页关键词搜索热度/评分排序标准分页加载如果你后续要做完整前端页面可以在此基础上继续扩展搜索框防抖、分页组件、排序下拉框、空状态和错误重试等。