RepoCritic Movieman

Multiple Platforms. Multiple Movies. We give fun short descriptions of different repos.

原始信息汇总

RepoCritic Movieman 数据集详情

数据集概述

RepoCritic Movieman 是一个将软件仓库与电影关联的趣味性数据API服务。该API能够为GitHub、GitLab、Bitbucket及npm平台上的任意项目生成幽默的电影风格短描述，并基于项目的真实数据（如星标数、下载量、语言、主题等）从包含66,111部真实电影的语料库中选择匹配的电影。

核心功能

• 仓库查询与描述生成：支持通过repo参数（精确ID）或query参数（关键词搜索）获取项目信息及其电影风格描述
• 多平台仓库合并：自动识别并合并同一项目在不同平台（GitHub、npm等）上的信息，如chalk项目同时拥有GitHub的23,306星标和npm的19.7亿月下载量
• 电影卡片生成：可选生成1200×630像素的PNG格式海报卡片（base64编码）
• 数据可靠性保证：仅当包清单明确声明仓库时才会进行跨平台合并，避免名称相似造成的错误关联

API端点

• 接口路径：GET /api/v1/git-repo-hub/description

主要参数

参数	默认值	说明
repo	—	精确项目标识，如github:chalk/chalk
query	chalk	通过名称、owner/repo、包名或关键词搜索
card	none	设置为base64时返回内联PNG图片
sources	all	限定来源：github,gitlab,bitbucket,npm
sort	relevance	排序方式：relevance, stars, updated
refresh	false	强制生成新的描述而非使用缓存

响应数据结构

• 顶层字段：success（布尔）、timestamp（ISO-8601时间）、data.query、data.selection、data.results[]、data.providers[]
• selection对象：包含mode（exact或search）、ambiguous（是否模糊匹配）、reason、candidates_considered、returned
• repo对象：包含id、provider、name、full_name、description、url、homepage、availability[]（各平台信息，含星标或下载量）、owner、stars、forks、open_issues、language、topics[]、license、archived、created_at、last_commit_date、package_name、downloads_monthly、version、part_of（所属monorepo）、match_score（0-1匹配度）
• roast对象：包含subject（匹配的电影/演员/角色）和line（生成的描述文本）
• generated对象：包含cached、fetch_count、regenerated、model、source
• card对象（仅当card=base64时）：包含content_type、width、height、base64

使用限制与特性

• 每日配额：每密钥每天10,000次调用，响应头包含x-ratelimit-limit、x-ratelimit-remaining、x-ratelimit-reset
• 部分故障容错：如有单个数据源（如GitLab）故障，仍返回其他源的数据，并通过providers[]数组标注受影响来源
• 请求追踪：每个响应携带x-request-id供问题排查
• 错误码：400（参数错误）、404（无匹配）、422（拒绝生成）、429（超限）、502/504（上游故障）
• 适用场景：变更日志、README徽章、standup机器人、发布说明及依赖流行度讨论

开发者资源

提供JavaScript（fetch）和Python（requests）两种语言的调用示例代码，支持RapidAPI平台的订阅使用。