← 返回 Skills 市场

Get Token Metadata

Name: Get Token Metadata
Author: ryley-o

作者 ryley-o · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

146

总下载

当前安装

版本数

在 OpenClaw 中安装

/install get-token-metadata

功能描述

Retrieve rich metadata for a specific Art Blocks token using artblocks-mcp. Use when a user wants to look up a minted token's details, traits, features, medi...

使用说明 (SKILL.md)

Getting Art Blocks Token Metadata

Tool: `get_token_metadata`

Retrieves a single token's full metadata in one call — traits, media URLs, owner, hash, listing info, and project context. Prefer this over graphql_query when you need rich token details for a known token ID.

Token ID Format

\x3Ccontract_address>-\x3Ctoken_number>

Example: 0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-78000000

Parameters

Param	Required	Notes
`tokenId`	yes	Full token ID `\x3Ccontract_address>-\x3Ctoken_number>`
`chainId`	—	Default `1` (Ethereum). `1`, `42161` (Arbitrum), `8453` (Base)

Response Shape

The response has three top-level keys: token, media, and project.

token:
  id, tokenId, chainId, contractAddress, projectId
  hash              — 32-byte hex, the source of all randomness
  invocation        — mint number within the project (0-indexed)
  features          — on-chain traits object
  featuresStatus    — "not_defined" | "defined_empty" | "defined"
  mintedAt, mintTransactionHash
  ownerAddress
  listing           — null if not listed, otherwise:
    listing.price      — listing price
    listing.currency   — currency symbol (ETH, WETH, etc.)
    listing.platform   — marketplace name
    listing.url        — listing URL
  artBlocksUrl      — direct link to the token page on artblocks.io

media:
  imageUrl          — primary rendered image
  previewUrl        — preview asset URL
  liveViewUrl       — live interactive generator URL
  hasVideo          — true if a video render exists

project:
  id, name, artistName, slug
  artBlocksUrl      — direct link to the project page on artblocks.io
  description, website, license
  scriptTypeAndVersion
  maxInvocations, invocations, remaining
  active, paused, complete
  aspectRatio, curationStatus, verticalName, verticalDisplay
  renderComplete

When to Use vs GraphQL

Use `get_token_metadata` when...	Use `graphql_query` when...
You have a specific token ID and want everything about it	You need to query multiple tokens at once
You need media URLs (`liveViewUrl`, `imageUrl`)	You need fields not in this response
You want features + project context in one call	You're building complex filters or aggregations

Notes

liveViewUrl is the canonical way to share or preview a generative token — always include it when presenting a token to a user
features is the on-chain traits object — same data shown on Art Blocks website
featuresStatus distinguishes between "artist hasn't defined features" (not_defined), "features are defined but empty for this token" (defined_empty), and "features exist" (defined)
hash uniquely identifies the token's visual output — same hash always produces the same artwork
listing is null when the token has no active secondary-market listing; when present it contains price, currency, platform, and url
Both token.artBlocksUrl and project.artBlocksUrl link to artblocks.io — use these when presenting tokens to users

安全使用建议

This skill is a documentation-only helper describing an internal get_token_metadata tool and appears low-risk: it needs no credentials or installs. Before enabling, confirm that your agent runtime actually provides the referenced get_token_metadata capability (the SKILL.md assumes that tool exists) and that any network calls it makes follow your environment's privacy and rate-limit policies. If future versions add install steps or environment variables, re-evaluate for scope creep or unnecessary credential requests.

功能分析

Type: OpenClaw Skill Name: get-token-metadata Version: 1.0.0 The skill bundle contains documentation and instructions for an AI agent to use the 'get_token_metadata' tool from the Art Blocks MCP. The files (SKILL.md and _meta.json) describe legitimate parameters and response structures for retrieving NFT metadata and do not contain any executable code, data exfiltration attempts, or malicious prompt injection.

能力评估

✓ Purpose & Capability

Name/description match the SKILL.md: the skill documents a single-purpose helper (get_token_metadata) for Art Blocks tokens and does not request unrelated binaries, env vars, or config paths.

✓ Instruction Scope

SKILL.md contains only usage documentation and the expected response shape for a single-token metadata call; it does not instruct reading files, exporting credentials, or contacting unexpected endpoints beyond linking to artblocks.io for display.

✓ Install Mechanism

No install spec and no code files — lowest-risk instruction-only artifact. Nothing is downloaded or written to disk.

✓ Credentials

No environment variables, secrets, or external credentials required or declared; this is proportional for a read-only metadata lookup helper.

✓ Persistence & Privilege

always is false and the skill is user-invocable; it does not request persistent presence or modify other skills/configuration.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install get-token-metadata
安装完成后，直接呼叫该 Skill 的名称或使用 /get-token-metadata 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release of get-token-metadata skill. - Retrieve comprehensive metadata for a specific Art Blocks token using a single call. - Returns token details, media URLs (including live view), owner, listing info, traits/features, and project context. - Requires full token ID (`<contract_address>-<token_number>`), supports Ethereum, Arbitrum, and Base. - Designed for detailed lookup of a single token; prefer over GraphQL for full metadata on known tokens. - Response organized into `token`, `media`, and `project` sections for easy data access.

元数据

Slug get-token-metadata

版本 1.0.0

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 1

常见问题