收藏品市场研究

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install collectibles-market-research
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 collectibles-market-research。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

收藏品市场研究使用 Crawlora API 收集交易卡和体育收藏品的公开市场与 PSA 参考数据。它帮助 Openclaw Skills 用户将具体的收藏问题转化为有证据支持的简报，并保留卡片身份、评级或品相、刊登或销售状态、价格类型、平台和来源 URL。
此技能会区分 PSA 指导价、当前要价、当前出价、实际成交价和趋势信号，而不会将它们视为可以互换的数据。它用于研究，不用于鉴定、保证估价、投资建议、竞拍或购买，并会指出数据覆盖范围和比较方面的限制。

应用场景

确认卡片、系列、主题或 PSA 认证，并查找相关参考数据。
比较 COMC、Fanatics Collect、ALT、Goldin 和 Pristine Auction 上的在售刊登和拍卖标的。
针对明确的研究问题，查看已售商品证据、拍卖历史、市场趋势或直播拆盒库存。
创建卡片或拍卖标的候选清单，记录来源、评级或品相、价格、状态和准确的来源 URL。
浏览 PSAStore、PristineMarketplace 或 Fanatics 的零售目录，同时将商品价格和库存与拍卖结果分开。
生成范围明确的市场快照，但不宣称其代表保证的公允价值、真伪、稀有度或投资回报。

工作原理

规范研究目标：主题、年份、品牌或系列、卡号、平行版、语言、评级，以及请求涉及在售、已售还是拍卖证据。
使用 PSA 发现路由查询类别、系列、清单和价格指南。仅在有认证编号时使用认证查询，并将其结果视为关于该认证和评级的证据。
使用精确的搜索词查询相关市场，然后根据返回的标识符访问刊登或详情路由。
记录每条结果的平台、来源 URL 或平台 ID、刊登类型、价格类型和币种、品相、评级及状态。
仅比较足够相似的商品，并考虑卡片身份、评级、平行版、语言、销售类型和时间范围。谨慎去除跨平台重复项，不要在不说明的情况下合并不同卖家或平台的数据。
总结观察到的价格范围和证据数量，清楚区分指导价、当前要价、当前出价、已售价格和趋势信号；如果平台覆盖范围有限或数据无法直接比较，应予以披露。

配置指南

从 crawlora.net 获取 Crawlora API 密钥。
运行辅助工具前，在环境中设置 CRAWLORA_API_KEY。请求将发送至 https://api.crawlora.net/api/v1。
使用受支持的路由和查询参数运行提供的 scripts/crawlora.sh 辅助工具。以下示例将 JSON 输出通过管道传给 jq，以便于阅读。
export CRAWLORA_API_KEY="your_api_key"
scripts/crawlora.sh /psa/price-guide/search query="1986 Topps Jordan" | jq '.'
scripts/crawlora.sh /psa/cert-lookup cert_number=12345678 | jq '.'
scripts/crawlora.sh /comc/search query="1986 Topps Jordan" | jq '.'
scripts/crawlora.sh /fanaticscollect/sold-items title="Jordan" | jq '.'
scripts/crawlora.sh /goldin/auctions query="Mantle" | jq '.'
scripts/crawlora.sh /alt/market-trends | jq '.'
零售目录示例：
scripts/crawlora.sh /psastore/collections limit=10 page=1
scripts/crawlora.sh /pristine-marketplace/search q="signed jersey" limit=16 page=1
scripts/crawlora.sh /fanatics/categories

数据架构

围绕收藏品规范化后的身份整理研究结果，并将每个平台的结果作为独立证据保留。研究简报应记录：
字段 需要保留的内容
身份 主题、年份、品牌或系列、卡号、平行版和语言
认证和评级 提供时记录 PSA 认证编号和评级；不要将某个认证结果泛化到所有同款卡片
品相 市场平台上的品相标签，与评级状态分开记录
来源 平台和准确的来源 URL 或平台标识符
交易背景 在售刊登、拍卖标的、已售商品、趋势信号或零售商品
价格 金额、币种，以及属于要价、当前出价、实际成交价还是指导价
状态和时间 刊登或库存状态，以及可用的更新时间或销售时间
证据范围 结果数量、比较时间范围，以及已知的覆盖范围或分页限制
PSA 参考数据应与市场证据分开。零售目录中的价格、款式、库存状态和商品品相，并非实际拍卖成交价。即使请求的 limit 更大，PristineMarketplace 搜索每页仍使用固定网格，最多返回 16 件商品；不要将请求的数量上限描述为完整覆盖。

高级特性

支持通过类别、系列、清单、价格指南搜索和认证查询发现 PSA 数据。
查询多个市场和证据类型，包括在售刊登、拍卖、已售商品、市场趋势和直播拆盒库存。
纳入 PSAStore、PristineMarketplace 和 Fanatics 的零售目录背景信息，并支持商品、系列或类别发现。
鼓励使用来源 URL 或平台 ID 谨慎去除跨平台重复项，同时保留卖家和平台之间的区别。
保留价格含义、评级、品相、销售状态、币种和来源信息，确保研究可审计。
明确证据限制：仅使用公开数据，不执行账户或购买操作，也不提供真伪鉴定、评级、保证估价或投资回报声明。
指出平台在覆盖范围、分页、费用、运费、品相标签、币种和更新时间方面的差异，避免误导性比较。

name: collectibles-market-research description: Researches public trading-card and sports-collectible markets through the Crawlora API — card identity, PSA certification and price-guide evidence, live listings, auctions, sold items, and market trends. Use when the user wants a sourced collector or buying brief, not authentication, appraisal guarantees, or a purchase action.

Collectibles market research

Build evidence-backed briefs for trading cards and sports collectibles from public marketplace and PSA reference data. Keep identity, condition, grade, listing status, sale status, and source platform separate: an asking price is not a sale, and a PSA guide value is not a guaranteed market price.

When to use this skill

Identify a card, set, subject, or certification and check PSA reference data.
Compare live listings or auction lots across COMC, Fanatics Collect, ALT, Goldin, and Pristine Auction.
Review sold-item evidence, auction history, market trends, or live-break inventory for a bounded collecting question.
Build a short list of cards or lots with provenance, grade/condition, price, status, and the exact source URL.

Setup

Get a Crawlora API key at crawlora.net.
Set CRAWLORA_API_KEY in the environment before running the helper.
The helper reads CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1.

Research workflow

Normalize the target before searching: player/subject, year, brand/set, card number, parallel/language, grade, and whether the user wants live, sold, or auction evidence.
Use PSA discovery routes for categories, sets, checklists, and price-guide search. Use psa_cert_lookup only with a certification number; a cert result describes that cert and grade, not every copy of the card.
Search marketplaces with the narrowest supported terms and follow returned identifiers into listing/detail routes. Preserve the platform, listing type, asking/current bid/realized price, currency, condition, grade, and status.
Compare like with like: same card identity, grade, parallel, language, sale type, and time window. Deduplicate cross-posted items by source URL or platform id, but do not merge different sellers or platforms silently.
Report observed ranges and evidence counts. Separate PSA guide values, active asks, current bids, sold prices, and market-trend signals; do not claim a fair value, profit, rarity, authenticity, or investment return from a bounded sample.

Examples

scripts/crawlora.sh /psa/price-guide/search query="1986 Topps Jordan" | jq '.'
scripts/crawlora.sh /psa/cert-lookup cert_number=12345678 | jq '.'
scripts/crawlora.sh /comc/search query="1986 Topps Jordan" | jq '.'
scripts/crawlora.sh /fanaticscollect/sold-items title="Jordan" | jq '.'
scripts/crawlora.sh /goldin/auctions query="Mantle" | jq '.'
scripts/crawlora.sh /alt/market-trends | jq '.'

Limits

Public data only; no account, purchase, bid, submission, authentication, or grading action is performed.
Coverage, pagination, condition labels, fees, shipping, currency, and update times differ by platform. Say when a comparison is not apples-to-apples.
PSA price-guide and population fields are source-specific reference signals; they do not establish a card's current sale value or guarantee authenticity.

Retail catalog context

PSAStore and PristineMarketplace expose storefront products and collections; Fanatics exposes sports-merchandise search and category/product detail. These are retail catalogs, distinct from PSA certification/price-guide evidence, Pristine Auction lots, and Fanatics Collect sold items. Discover collection handles or category URLs before retrieving products, and keep price, variant, stock status, and product condition separate from realized auction prices. PristineMarketplace search uses a fixed grid of at most 16 products per page even when a larger limit is requested. Do not infer complete coverage from a large requested limit. Reviews may describe the storefront, rather than the individual collectible. Merchandise availability does not prove authenticity or card rarity.

scripts/crawlora.sh /psastore/collections limit=10 page=1
scripts/crawlora.sh /pristine-marketplace/search q="signed jersey" limit=16 page=1
scripts/crawlora.sh /fanatics/categories

FotMob 足球研究
国会披露研究