BrickEconomy 砖块经济

BrickEconomy AFOL 技能 当用户询问关于 LEGO 套装价值、迷你人物价值、BrickEconomy 收藏估值、收藏增长、投资表现、预测、ROI 或销售账本利润/亏损时，使用此技能。 主要接口：scripts/brickeconomy 此技能为自包含的存档分布，直接使用 checked-in 引用包装 BrickEconomy API：OpenAPI 引用：references/openapi/brickeconomy.yaml 领域指导：references/prompts/brickeconomy-tools.txt CLI 源代码：scripts/brickeconomy_cli.py 不要抓取供应商文档或发明参数，当 checked-in OpenAPI 引用涵盖端点时。 如果引用不足，请说明缺失的内容。 身份验证 所需环境变量：export BRICKECONOMY_API_KEY=... 可选覆盖：export BRICKECONOMY_BASE_URL=https://www.brickeconomy.com/api/v1 永远不要打印、提交、记录或粘贴真实 API 密钥。 命令应仅通过 CLI 间接引用 $BRICKECONOMY_API_KEY。 BrickEconomy 身份验证位置很重要：每个 API 调用都将密钥作为 x-apikey HTTP 标头发送，而不是作为查询参数或表单字段。 CLI 快速参考 从此技能目录运行命令： scripts/brickeconomy --help scripts/brickeconomy set --set-number 10236-1 --currency EUR scripts/brickeconomy minifig --minifig-number sw0509 --currency USD scripts/brickeconomy collection-sets --currency EUR scripts/brickeconomy collection-minifigs --currency EUR scripts/brickeconomy sales-ledger 所有命令都是只读的。 使用 --dry-run 来检查请求形状，而不需要 API 密钥或调用 BrickEconomy： scripts/brickeconomy set --dry-run --set-number 10236-1 --currency EUR scripts/brickeconomy sales-ledger --dry-run 安全规则 checked-in 的 BrickEconomy 规范仅包含只读 GET 端点： set minifig collection-sets collection-minifigs sales-ledger 此技能存档中没有集合变异、市场列表、订单更新、愿望清单、删除或批量更新端点。 仍然要小心：将返回的集合和销售账本数据视为私人财务/账户数据。 除非用户要求个人集合、ROI 或销售分析，否则不要调用个人集合或销售账本端点。 除非用户要求批量分析并且 100 次/天、4 次/分钟的限制预算是可接受的，否则不要进行大量的套装/迷你人物查找。 如果将来的 BrickEconomy 引用添加了变异端点，请在当前对话中要求用户明确确认，并使用机械防护，如 --yes；同时保持 --dry-run 可用。 端点覆盖 工作流 CLI 命令 方法/路径 操作 备注 套装价值 set --set-number 10236-1 --currency EUR GET /set/{setNumber} getSet 接受带或不带变体后缀的套装编号，例如 10236 或 10236-1。支持可选货币。 迷你人物价值 minifig --minifig-number sw0509 --currency USD GET /minifig/{minifigNumber} getMinifig 接受 BrickEconomy 迷你人物编号，例如 sw0509。支持可选货币。 集合套装 collection-sets --currency EUR GET /collection/sets getCollectionSets 返回所有经过身份验证的套装集合条目，包括已支付价格、当前价值、增长、获取、条件和集合字段。 集合迷你人物 collection-minifigs --currency EUR GET /collection/minifigs getCollectionMinifigs 返回所有经过身份验证的迷你人物集合条目，包括已支付价格、当前价值、增长、获取和集合字段。 销售账本 sales-ledger GET /salesledger getSalesLedger 返回套装和迷你人物销售记录，包括销售价格、费用/运费、数量、购买价格、日期、条件和备注。 此端点在规范中没有定义货币参数。 规范中支持的货币代码：USD、GBP、CAD、AUD、CNY、KRW、EUR、JPY、CHF、INR、BRL、RUB、ZAR、MXN、SGD、HKD、SEK、NZD、NOK、TRY、DKK、PLN。 API 默认值为 USD。 从 references/prompts/brickeconomy-tools.txt 中的已知 BrickEconomy 限制：100 次/天和 4 次/分钟。 要吝啬：当分析用户的投资组合时，一次集合调用比 N 个单独的套装调用更好。 分析规则 所有分析必须基于 API 响应字段。 除非用户明确要求多提供商回退并命名来源，否则不要从内存、网页搜索、BrickLink 或其他提供商填充缺失值。 对于套装价值响应，使用以下字段： current_value_new、current_value_used、current_value_used_low、current_value_used_high forecast_value_new_2_years、forecast_value_new_5_years rolling_growth_lastyear、rolling_growth_12months price_events_new、price_events_used retired、released_date、retired_date、retail_price_*、currency 对于迷你人物价值响应，使用以下字段： 当前值字段 当存在时的预测和增长字段 set_count、sets、theme、subtheme、year、currency