Image URL Extraction Skill

Extract direct image URLs from archive HTML pages using source-specific patterns.

Updated Jun 23, 2025
One-click install
npx skills add https://github.com/EsyResearch/home.esy.com --skill image-url-extraction-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Image URL Extraction Skill
Source: https://github.com/EsyResearch/home.esy.com/tree/main/orchestration/skills/image-url-extraction
Command: npx skills add https://github.com/EsyResearch/home.esy.com --skill image-url-extraction-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill reliably retrieves direct image URLs from archive HTML pages (e.g., Wikimedia Commons, LOC, Smithsonian, Met, NARA) to prevent broken images in visual essays and downstream workflows.

Core Features & Use Cases

  • Deterministic extraction: Uses source-specific reference files to locate the actual image URL from archive pages.
  • Source coverage: Supports Wikimedia Commons, Library of Congress, Smithsonian, Metropolitan Museum of Art, National Archives, and a generic fallback path for unknown sources.
  • Verification & reliability: Includes URL verification and content-type checks to ensure the URL resolves to an image, not HTML.
  • Operational integration: Designed to be invoked by image curation agents and to feed directly into embedding or download workflows.

Quick Start

Identify the source by URL pattern, open the corresponding reference file, run the extraction per that reference, verify the extracted URL is an image, and then use it as the direct image URL.

Frequently Asked Questions about Image URL Extraction Skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract direct image URLs from Wikimedia Commons or Library of Congress archive pages?

To extract direct image URLs from archive pages, match the source URL pattern, apply source-specific extraction rules from reference files, and verify the resolved Content-Type is an image before use.

Why do images break in visual essays when using archive page links?

Images break in visual essays because archive page links often return HTML wrappers instead of direct image files. You must extract the direct image URL and verify its Content-Type resolves to an actual image, not HTML.

Does the image URL extraction method work for Smithsonian and Metropolitan Museum of Art archives?

Yes, the image URL extraction method works for Smithsonian and Metropolitan Museum of Art archives by applying source-specific patterns and a generic fallback path to retrieve direct image URLs.

What is the best way to verify that an extracted archive image URL points to a real image?

The best way to verify an extracted archive image URL points to a real image is to perform a deterministic extraction with curl and confirm the Content-Type header is strictly image/* before using the URL.

Can I extract image URLs from unknown archive sources not listed in the supported sources?

Yes, you can extract image URLs from unknown archive sources by using the generic fallback extraction path, which attempts to locate the direct image URL without relying on source-specific reference files.