museum-art

museum-art：用于视觉素材的公有领域艺术作品

长期规则（于 2026-07-24 采纳，源自 Eric Li 关于博物馆开放访问的帖子）：每当视觉内容需要一张具有审美分量的真实图像时，应优先选用博物馆的公有领域艺术作品，而不是 AI 生成图像或普通图库素材。经过策展、具有重要历史意义的艺术作品显得可信且精致；AI 生成图像则显得粗制滥造。这条规则与 no-ai-slop 技能及你们的图像风格相辅相成、彼此强化。它不会取代生成式 editorial-illustrations 技能（该技能负责由论点驱动的图表／插图），也不会取代你们的图表风格——照片、主视觉、装饰性或氛围类图像使用博物馆艺术作品，数据图和概念图则使用生成式插图。

何时使用

• 博客文章主视觉、章节分隔图、氛围类图像（博客发布时的图像步骤）。
• 演示文稿／幻灯片背景和章节分隔页、社交媒体卡片、文章插图、规格说明封面图。
• 每当你本能地想为装饰性或富有感染力的内容“生成一张图像”时。停下来，找一幅真实的绘画作品。
• 不适用于：产品截图、UI 模型、数据图表、徽标或由论点驱动的解释性图表（这些应使用 editorial-illustrations 或真实截图）。

决策：选择哪个来源

1. 优先选择 Met → Cleveland → SMK。 都无需密钥，只需一次 JSON 请求，作品为 CC0／PD，馆藏广泛。获取高分辨率图像的最快途径。
2. 需要荷兰／佛兰德大师作品或装饰艺术？ 选择 Rijksmuseum（无需密钥，需要 3 次请求）。
3. 需要欧洲古物／摄影作品，且关键词并非必要条件？ 选择 Getty（无需密钥，使用 SPARQL）。
4. 找不到合适作品，或者想跨博物馆搜索？ Wikimedia Commons API（无需密钥的聚合平台，许可证元数据已标准化）是最佳的通用备用方案。
5. 想要的是“历史插画／版画／老照片”，而非美术绘画？ 直接使用 Internet Archive 或 Wikimedia Commons。
6. 科学／健康／医学文章插图？ 使用 Wellcome Collection（无需密钥，CC0／PD）。

如何在此环境中获取

• 使用 WebFetch 请求 JSON 搜索端点，然后使用 WebFetch／下载返回的图像 URL。这些 API 可从服务端访问；无需浏览器。
• 例外——Art Institute of Chicago 图像： JSON API（api.artic.edu）可正常使用，但图像主机 www.artic.edu/iiif/... 会因 Cloudflare 机器人验证而拒绝脚本／curl 请求，返回 403。可以使用 AIC 的 JSON 元数据，但实际图像需通过真实／无头浏览器（browser-harness）下载，或者选择其他博物馆获取图像文件。
• 发布前，始终在查询中筛选公有领域作品，并逐一抽查图像的许可证标记（见 Licensing）。

每次获取新图，禁止依赖缓存（强制）

每次有需要时都要获取新图。不要建立可重复使用的本地图像下载池。 小规模缓存的图像集会被反复使用，最终变成“每篇文章都用同一张图库照片”——雷同本身就是一种粗制滥造，而大型开放馆藏的丰富多样性正是全部意义所在。获取图像无需密钥，而且只需不到一秒，因此没有缓存图像文件的成本理由。

• 缓存获取方案／元数据，不缓存图像——这正是此技能的 references/ 已经提供的内容。
• 选定图像后，仅将其提交到实际使用它的特定成品中（文章的 assets/、演示文稿的媒体资源），以保留来源记录并支持离线构建。它是成品专属素材，不是其他成品可以调用的共享素材库。
• 每个新视觉内容都要使用新查询。更换搜索词和来源博物馆，避免连续发布的文章总是出现同几幅热门作品。

已验证的免密方案（2026-07-24，均已在线测试）

1. The Met——最佳全能默认选项

• 基础地址：https://collectionapi.metmuseum.org/public/collection/v1/——无需密钥，每秒 80 次请求；isPublicDomain:true 的内容采用 CC0 许可。
• 搜索：GET /search?q=<term>&hasImages=true&isPublicDomain=true -> {total, objectIDs[]}
• 对象：GET /objects/{id} -> 读取 primaryImage（全分辨率 JPEG，静态图片，无需经过 IIIF）或 primaryImageSmall（适合网页的大尺寸图片）。
• 示例：https://collectionapi.metmuseum.org/public/collection/v1/search?q=sunflowers&hasImages=true&isPublicDomain=true

2. 克利夫兰艺术博物馆——唯一提供档案级 TIFF 的博物馆

• 基础地址：https://openaccess-api.clevelandart.org/api/artworks/——无需密钥，采用 CC0 许可。
• 搜索：GET /api/artworks/?cc0=1&has_image=1&limit=10（可添加 &q=monet、&skip=10）。
• 每条结果中的图片字段：images.web.url（900px）、images.print.url（3400px JPEG）、images.full.url（档案级 TIFF）。可直接从 openaccess-cdn.clevelandart.org 下载。
• 确认每条结果的 share_license_status == "CC0"。

3. SMK（丹麦）——一步直达，涵盖范围广泛的欧洲和北欧艺术

• 基础地址：https://api.smk.dk/api/v1——无需密钥。许可：Public Domain Mark 1.0（实际效果等同 CC0）。
• 搜索：GET /art/search?keys=*&filters=[public_domain:true]&filters=[has_image:true]
• 直接从每条结果读取 image_native（无需经过中间环节）。
• 注意（已验证）：将 filters 作为重复的查询参数传递，每个参数包含一个 [field:value]。将它们拼接为 filters=[public_domain:true][has_image:true] 虽会返回 200，但会悄悄忽略第二个条件。

4. 荷兰国立博物馆——荷兰和佛兰德斯大师作品（无需密钥，需经过 3 个环节）

• 基础地址：https://data.rijksmuseum.nl/search/collection（Linked Art，无需密钥）。
• GET /search/collection?type=painting&imageAvailable=true -> 依次遍历 object -> VisualItem -> DigitalObject -> access_point[0].id 是可直接使用的 IIIF URL。
• 许可混合：大多采用 CC0/PD 许可，但部分采用 CC BY 4.0——请检查每个对象的权利信息块（CC BY 作品需要注明出处）。

5. NGA（华盛顿）——批量/离线获取，不支持实时搜索

• CSV：https://raw.githubusercontent.com/NationalGalleryOfArt/opendata/main/data/published_images.csv——筛选 openaccess=1。
• 图片（IIIF）：https://api.nga.gov/iiif/{uuid}/full/full/0/default.jpg
• openaccess=0 的单张图片记录并非开放内容（分辨率受限，且权利受限）。只有 openaccess=1 的内容可免费使用。

6. 芝加哥艺术博物馆——印象派/欧洲艺术（图片主机注意事项）

• JSON：GET https://api.artic.edu/api/v1/artworks/search?query[term][is_public_domain]=true&fields=id,title,image_id——无需密钥，采用 CC0 许可。
• 图片：构建 https://www.artic.edu/iiif/2/{image_id}/full/843,/0/default.jpg——但 Cloudflare 会对脚本抓取返回 403；请通过浏览器下载，或改用其他博物馆获取图片数据。

7. Getty——欧洲绘画/摄影/古物（SPARQL）

• 基础地址：https://data.getty.edu/museum/collection/——无需密钥。不支持关键词搜索；使用 SPARQL 查询 ?obj crm:P138i_has_representation ?img，即可在同一查询中返回可直接使用的 IIIF 图片 URL。
• 数据集采用 CC0 许可；各图片的权利信息填写情况不一致——商业使用前，请访问对象在 getty.edu 上的公开页面进行核对（“Download”按钮表示该内容属于真正的 Open Content）。

需 API 密钥及聚合器的数据源（也请了解）

• Smithsonian（需要免费的 api.data.gov 密钥；DEMO_KEY 每小时可用 30 次）：GET https://api.si.edu/openaccess/api/v1.0/search?q=<term> AND online_media_type:Images&api_key=KEY；CC0；逐张图片检查 media[].usage.access=="CC0"。覆盖范围极广（SAAM、NPG 肖像、Freer/Sackler 亚洲艺术、Cooper Hewitt 设计）。
• Wikimedia Commons（无需密钥，是最佳聚合器备选）：https://commons.wikimedia.org/w/api.php?action=query&generator=search&gsrsearch=<term>&gsrnamespace=6&prop=imageinfo&iiprop=url|extmetadata；每个文件的许可信息见 extmetadata.LicenseShortName；通过 Special:FilePath/{filename} 获取原始字节。
• Wellcome Collection（无需密钥）：https://api.wellcomecollection.org/catalogue/v2/works?query=<term>；CC0/PD 医学、科学和历史图像。
• Internet Archive（无需密钥）：https://archive.org/advancedsearch.php?q=<term>&fl[]=identifier&output=json；PD 书籍插图、版画、历史照片和杂项印刷品。
• Europeana（免费密钥）：https://api.europeana.eu/record/v2/search.json?wskey=<KEY>&query=<term>；汇集欧洲各机构的 5,000 多万件藏品。
• Harvard Art Museums（免费密钥）：https://api.harvardartmuseums.org/object?apikey=<KEY>&q=<term>。
• Yale LUX（无需密钥，类似 Getty 的 Linked Art）：https://lux.collections.yale.edu/api/search/...；英国艺术和珍本书籍资源丰富。
• Paris Musees（无需密钥，明确标注 CC0）：parismuseescollections.paris.fr / opendata.paris.fr；法国绘画及装饰艺术。
• NYPL Digital Collections（免费密钥）：https://api.repository.library.nyc/...；PD 版画、地图、照片和插图。
• DPLA（免费密钥）：https://api.dp.la/v2/items?q=<term>&api_key=<KEY>；汇集美国各地的馆藏。

许可规则（使用任何图片前都要遵守）

• **真正的 CC0（无需署名）：**Met、Cleveland、Art Institute of Chicago、Smithsonian、NGA（数据集层面；图片需通过每张图片的 openaccess=1 标记确认）。
• **Public Domain Mark / 开放但非 CC0（可免费使用，建议署名但不强制）：**SMK，以及 Rijksmuseum 中的 PD 子集。
• **逐张图片核实，切勿盲目相信整个馆藏层面的“开放获取”：**Getty、Rijksmuseum（CC BY 图片需署名）、NGA 和 Smithsonian 的单张图片标记。
• **规则：**如果 API 提供权利或许可字段，请在查询中据此筛选，并对选用的图片抽查核实。切勿假设“整个馆藏开放获取”就意味着“这张图片也开放获取”。
• **各处通用的良好做法：**添加一行署名（“数字图像由 [Museum] 惠允提供”）无需成本，还能适用于许可混杂的馆藏。按本项目风格进行遮罩或合成时，也要保留署名。

与其他技能的关系

• 与 no-ai-slop 和本项目的图片风格搭配：真实的博物馆艺术作品是营造意境时避免 AI 滥用风格的默认选择。
• 补充 editorial-illustrations（生成式、围绕论点展开的示意图）和 dataviz（图表）——前两者负责说明性图形，本技能负责照片、艺术作品和氛围类图像。
• 在图片来源选择环节，为 blog-publish、social-media-kit、weekly-ai-slide、演示文稿和文章提供素材。

参考资料（各博物馆完整操作指南，均已验证）

references/_synthesis.md（速查表）+ 每家博物馆各一份文件（met.md、cleveland.md、smk.md、rijksmuseum.md、nga.md、artic.md、getty.md、smithsonian.md），包含经过实测的示例 URL、字段说明和注意事项。