NFT 收藏流动性研究

安装指南

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

什么是

此技能可帮助智能体通过 Crawlora 构建具有来源归属信息的 OpenSea 收藏深度和活动观察快照。它可以调查收藏身份、买价和卖价、活动、持有者余额及特征，同时明确记录链、合约、代币、货币、时间范围和项目资格。
Openclaw Skills 用户可以使用它比较市场观察结果，同时避免混淆累计深度与边际深度、销售与转移，或报价与可执行订单。它会保留来源 ID、URL、来源日期、抓取时间和不完整的覆盖范围，并且不会进行投资预测或执行交易。

应用场景

使用兼容的项目资格、货币和价格基准，比较已验证 NFT 收藏的观察买价和卖价深度。
在区分销售、转移和铸造的同时，审查收藏活动的有限样本。
检查持有者余额或特定特征范围，但不将钱包视为已验证的个人所有者。
研究提供的收藏或发现候选收藏，然后验证链和合约身份。
为研究报告记录快照覆盖范围、缺失的执行详情和来源背景。

工作原理

确定请求的收藏集合、链、合约身份、项目或特征范围、报价货币、时间范围、比较需求和 Crawlora 点数预算。
根据需要发现链、类别和收藏 slug；核实实际合约、链、创建者和规范 URL，而不是依赖匹配的名称或 slug。
查询相关的 Crawlora OpenSea 数据面，以获取深度、活动、持有者或特征信息；连接后使用列出的 MCP 工具，否则使用捆绑的 shell 脚本。
同时检查 HTTP 状态和应用程序 code；从 data 读取结果。遇到身份验证错误时停止，HTTP 429 时退避，并对暂时性的上游故障重试一次。
分别解读每个数据面：保留深度梯级顺序和累计数量，区分销售与其他事件，并在分页时保留不透明的页面游标。
只比较兼容的观察结果。将原生货币与来源提供的 USD 估值区分开，并单独记录任何带日期的换算依据。
展示收藏和合约身份、观察时间、覆盖范围、解读后的深度、抽样活动、持有者或特征范围，以及缺失的执行条件；不得声称报价订单一定可以成交。

配置指南

在环境中设置 Crawlora API 密钥。若可用，请使用 Crawlora MCP 工具；否则调用捆绑脚本，该脚本会将密钥作为 x-api-key 发送到 Crawlora API。确切的方法和参数请参阅 reference/endpoints.md。
export CRAWLORA_API_KEY="YOUR_CRAWLORA_API_KEY"
scripts/crawlora.sh /opensea/chains
scripts/crawlora.sh /opensea/search/collections query="art" limit=5
验证收藏 slug 后，在请求的范围和点数预算内查询其数据面：
scripts/crawlora.sh "/opensea/collection/$SLUG/depth"
scripts/crawlora.sh "/opensea/collection/$SLUG/activity" event_types=SALE limit=20
除 HTTP 状态外，还要检查应用层 code。遇到身份验证错误时停止，收到 429 响应时退避，并对暂时性的上游故障重试一次。
NFT 收藏流动性研究 数据架构与分类体系
此技能描述观察结果及其来源信息；提供的说明未指定生成文件格式，也不要求将研究结果写入磁盘。捆绑的访问资源为 scripts/crawlora.sh 和 reference/endpoints.md。
数据区域 保留并解读
收藏身份 链、已验证合约、收藏或 slug、创建者和规范 URL。使用链 + 合约 + 代币 ID 标识项目。
观察来源信息 来源 ID 和 URL、来源日期，以及分别记录的观察或抓取时间。
范围和单位 项目或特征资格、报价货币、时间范围、价格基准、资产标准，以及任何带日期的货币换算依据。将原生金额与来源 USD 估值及执行成本分开。
深度 按顺序排列的价格档位、累计数量，以及累计深度与边际数量之间的区别。不要把累计档位相加并视为彼此独立的库存。
活动 事件类型和交易/事件身份。区分销售、转移、铸造及其他活动；保留捆绑交易的歧义和未知的单项目价格基准。
持有者和特征 钱包余额以及适用的特征或项目范围。不要根据钱包行推断独立个人或受益所有权。
覆盖范围和资格 已查询的页面或样本、不完整的覆盖范围、不透明游标，以及已报告或缺失的资格、到期时间、费用、余额、授权和执行详情。

高级特性

连接后使用 Crawlora MCP 工具，并提供捆绑的
scripts/crawlora.sh
作为备用方案，使用
CRAWLORA_API_KEY
进行身份验证。
支持按范围发现收藏，并针对不同的市场数据面开展研究，包括深度、活动、持有者和特征。
根据请求范围和点数预算执行有界调用及分页，并保留返回的不透明游标。
包含谨慎的重试处理：遇到身份验证错误时停止，429 时退避，并对暂时性的上游故障重试一次。
保留不完整的覆盖范围和来源信息，而不是将抽样观察结果呈现为完整的市场历史。
避免缺乏依据的结论：钱包行不能证明个人所有权，重复地址不能证明存在操纵行为，观察到的报价也不能证明订单可执行。
仅限研究用途：不预测转售价值、不评估投资质量、不关联钱包、不签署交易、不挂出报价、不购买资产，也不安排监控。

name: nft-collection-liquidity-research description: Compare observed OpenSea collection depth, bids/asks, activity, holders, and traits through Crawlora. Use for a source-attributed liquidity snapshot with chain/contract/item identity, cumulative quantities, currencies, eligibility, observation time, and incomplete coverage preserved.

NFT collection liquidity research

Access and scope

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the listed Crawlora MCP tools when connected; otherwise use the bundled scripts/crawlora.sh, which sends x-api-key to https://api.crawlora.net/api/v1. Read reference/endpoints.md for exact methods and parameters. Check application code as well as HTTP status; payloads are inside data. Stop on authentication errors, back off on 429, and retry a transient upstream failure once. Bound calls/pages by the requested scope and credit budget. Retain source IDs, URLs, source dates, and observation/crawl times separately.

Describe observed marketplace depth and activity for a supplied or discovered collection set. Establish chain, contract/collection identity, item/trait scope, quote currency, time window, and what depth/activity comparison is needed.

Resolve collection identity and distinct surfaces

Discover chains/categories and collection slugs, then verify actual contract, chain, creator, and canonical URL when supplied. Similar display names and collection slugs do not prove authenticity or that two contracts represent the same assets. Item identity needs chain + contract + token ID, not token ID alone.
Keep active listings, offers, collection/trait offers, sales, transfers, mints, and holder balances separate. event_types=SALE selects a sales feed; transfer or mint events are not purchases. A top-sales shelf is fixed-size and price-ranked, not a chronological complete sales history. Copy opaque returned page cursors.
Collection depth exposes price levels with cumulative quantities. Preserve ladder order and distinguish cumulative depth from marginal quantity; adding cumulative levels double counts inventory. Confirm quantity/price basis and asset standard rather than equating every row with one unique NFT.
Offer/listing eligibility, expiration, fees, balances, approvals, and execution can differ or be unreported. Keep observed quote/depth separate from evidence of a completed sale. Missing detail does not establish a valid fillable order.
scripts/crawlora.sh /opensea/chains
scripts/crawlora.sh /opensea/search/collections query="art" limit=5

# Resolve a verified collection slug before:
# scripts/crawlora.sh "/opensea/collection/$SLUG/depth"
# scripts/crawlora.sh "/opensea/collection/$SLUG/activity" event_types=SALE limit=20

Compare depth with compatible measures

Use the same item/trait eligibility, timestamp, currency and price basis for bid/ask comparisons. ETH, WETH, stablecoins and source-provided USD estimates must not silently share one unit; any conversion needs a dated basis. Preserve source USD estimates separately from native amounts and execution costs. A floor ask and collection bid need not cover the same eligible item.

Holder rows represent wallet balances, not unique natural people or verified beneficial owners. A custodian/contract can hold for many users; several wallets can belong to one person. Holdings concentration requires compatible complete supply/balance denominators, not a top-N subtotal. Deduplicate sale events with transaction/event identity while retaining multi-item/bundle ambiguity and unknown price-per-item basis. Do not allege wash trading or manipulation solely from repeated addresses, outliers, or self-transfer-like patterns.

Return collection/contract identity, currency/time and coverage ledger, correctly interpreted ladders, sampled activity, holder/trait scope, and missing execution conditions. Do not predict resale value, declare investment quality, connect wallets, sign transactions, place offers, buy assets, or schedule monitoring from a snapshot research request.

宠物护理服务提供者筛选
游戏价格历史研究