使用 artblocks-mcp GraphQL 工具查询 Art Blocks 链上数据。在获取项目、代币、艺术家、销售、特征或任何 Art Blocks 链上信息时使用。
查询艺术块数据
功能概述
查询艺术块数据是一项面向实际任务的技能，主要用于当使用 GraphQL 时对域工具；域特定工具覆盖了大多数使用例, 并且更容易使用: 1.；
核心要点
- Need.；
- Tool.；
- Browse/ architecture. disproject. fulll project de。
使用与执行
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
结果检查与注意事项
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
查询 Art Blocks 数据
何时使用 GraphQL 与领域专用工具
领域专用工具覆盖了绝大多数使用场景，且更易于使用：
| 需求 | 工具 |
|---|---|
| 浏览/搜索项目 | discover_projects |
| 完整项目详情 | get_project |
| 艺术家全部作品 | get_artist |
| 资产组合概览 | get_wallet_summary |
| 收藏者持有的 Token | get_wallet_tokens |
| Token 详情 | get_token_metadata |
| 正在进行的铸造（Live mints） | discover_live_mints |
| 即将发布的项目（Upcoming drops） | discover_upcoming_releases |
| 铸造资格检查（Mint eligibility） | check_allowlist_eligibility |
请将下方的 GraphQL 工具作为备用方案，用于执行上述领域工具未覆盖的自定义查询——例如销售历史、聚合统计、复杂联结（joins），或尚未提供专用工具支持的数据表。
资源：artblocks://about
获取该资源可了解平台上下文信息，包括术语表、垂直领域分类、支持的链（chains）、标签（tags）、用户档案（user profiles），以及一份说明“各类工具分别负责哪些功能”的指南。
工具调用层级
按以下顺序使用工具；若无需某一步骤，可直接跳过：
- 探索数据结构 →
explore_table（返回单张表的字段及关联关系）或graphql_introspection（返回完整 Schema） - 构建经验证的查询 →
build_query（校验字段合法性、提供自动补全建议、并根据链自动添加过滤条件） - 查询优化 →
query_optimizer（将查询重写为推荐使用的表，例如优先使用projects_metadata而非projects） - 执行查询 →
graphql_query
若您已熟悉 Schema，可直接从 build_query → graphql_query 开始。
工具：explore_table
针对常用表（如 projects_metadata、tokens_metadata），该工具返回一组精选的最常用字段，按类别组织（如 Identity、Status、Media、Market 等），并附带关键关联关系及其推荐的子字段。若需查看完整 Schema，请传入参数 showAllFields: true。
| 参数 | 是否必需 | 说明 |
|---|---|---|
tableName |
是 | 待探索的表名 |
showAllFields |
— | 设为 true 可输出完整 Schema（默认为精选字段列表） |
推荐使用的表
请始终使用带 _metadata 后缀的表——它们包含更丰富的关联数据：
| 应使用 | 不建议使用 |
|---|---|
projects_metadata |
projects |
tokens_metadata |
tokens |
contracts_metadata |
contracts |
query_optimizer 将自动将使用非推荐表的查询重写为推荐表。
链 ID（Chain IDs）
| 链 | ID |
|---|---|
| Ethereum 主网 | 1（默认值） |
| Arbitrum | 42161 |
| Base | 8453 |
向 graphql_query 传入 chainId 参数后，即可在 GraphQL 查询中以变量 $chainId 的形式引用该值。
常见查询模式
以下示例展示了必须依赖原始 GraphQL 实现**的功能 —— 这些是领域专用工具无法完成的操作。
近期成交记录（无对应领域工具支持购买行为查询）
query {
purchases_metadata(
order_by: { block_timestamp: desc }
limit: 20
where: { chain_id: { _eq: 1 } }
) {
token_id
price_in_eth
block_timestamp
buyer_address
seller_address
}
}
按持有者聚合某项目的 Token 数量
query {
tokens_metadata_aggregate(
where: { project_id: { _eq: "0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-78" } }
distinct_on: owner_address
) {
aggregate { count }
}
}
获取某项目下所有 Token（领域工具仅支持按钱包维度返回）
query {
tokens_metadata(
where: { project_id: { _eq: "0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-0" } }
order_by: { invocation: asc }
limit: 50
) {
token_id
invocation
owner_address
features
}
}
筛选具备特定链上属性的项目
query {
projects_metadata(
where: {
script_type_and_version: { _ilike: "%three%" }
chain_id: { _eq: 1 }
complete: { _eq: false }
}
limit: 20
) {
id
name
artist_name
script_type_and_version
invocations
max_invocations
}
}
使用提示
- 编写查询前，先使用
explore_table理解字段含义与关联关系——其精选视图比完整 Schema 更易快速浏览 build_query是最安全的起点：它会校验字段合法性，并明确告知您当前可用的字段- 查询多链数据时，请务必传入
chainId，避免跨链噪声干扰结果 - 若仅需验证未知字段是否存在，
validate_fields比完整 Schema 自省（introspection）更快
热门AI工具
相关专题
本专题从实际API接口调试场景出发，讲解Postman身份认证的完整配置流程，包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查，帮助用户正确完成接口授权与访问验证。
0
2026.11.06
围绕Postman HTTP请求头配置展开，讲解Headers选项的具体使用方式，包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法，帮助用户解决接口调试过程中遇到的请求头配置问题。
0
2026.11.06
详细介绍Postman接口请求的创建与发送方法，涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看，帮助用户掌握Postman接口请求的完整操作流程。
0
2026.11.06
DBeaver数据导入专题，整理Excel、CSV、SQL、TXT等常见文件的数据导入方法，涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作，帮助用户将本地文件中的数据写入数据库，并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。
0
2026.11.05
DBeaver安全防护专题，围绕数据库连接安全、账号密码保护和访问权限管理展开，整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法，同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项，帮助用户提高数据库日常管理的安全性。
0
2026.11.05
本专题聚焦DBeaver数据库连接配置与管理，覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库，整理相应的连接设置方法，并提供驱动缺失、认证失败和连接异常等问题的排查方向。
0
2026.11.04
本专题围绕XORM框架的结构体映射展开，说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充，并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。
0
2026.11.04
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.8万人学习
共6课时 | 54.7万人学习
最新文章
