edward/flickr-mail
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity

Update README and AGENTS with category search and license features

Browse source 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Edward Betts 2026-02-07 10:26:56 +00:00
parent c5efd429ce
commit ac1b01ea68
2 changed files with 72 additions and 21 deletions
Download patch file Download diff file Expand all files Collapse all files

28
README.md
View file

@ -22,16 +22,23 @@ photographers on Flickr whose photos can be used to enhance Wikipedia articles.
- **Integrated Flickr search**: Enter a Wikipedia article title and see Flickr
photos directly in the interface - no need to visit Flickr's search page.
- **Photo grid with metadata**: Search results display as a grid of thumbnails
showing the photographer's name and license for each photo.
- **License highlighting**: Photos with Wikipedia-compatible licenses (CC BY,
CC BY-SA, CC0, Public Domain) are highlighted with a green badge.
showing the user's name and license for each photo.
- **License handling**: Photos with Wikipedia-compatible licenses (CC BY,
CC BY-SA, CC0, Public Domain) are highlighted with a green badge and link
directly to the Commons UploadWizard. Non-free CC licenses (NC/ND) show a
tailored message explaining Wikipedia's requirements. Supports both CC 2.0
and CC 4.0 license codes.
- **One-click message composition**: Click any photo to compose a permission
request message with the photo displayed alongside.
request message with the photo displayed alongside, showing the user's Flickr
profile and current license.
- **Previous message detection**: The message page checks sent mail history and
warns if you have previously contacted the user.
- **Category search**: Find Wikipedia articles without images in a given
category, with links to search Flickr for each article.
- **Pagination**: Browse through thousands of search results with page navigation.
- **Recent uploads showcase**: The home page displays recent Wikimedia Commons
uploads that were obtained via Flickr mail requests, with links to the
Wikipedia article and photographer's Flickr profile.
- Generate messages to request permission to use photos on Wikipedia.
Wikipedia article and user's Flickr profile.
- Handle exceptions gracefully and provide detailed error information.
## Usage
@ -40,11 +47,14 @@ To use the tool, follow these steps:
1. Start the tool by running the script.
2. Access the tool through a web browser.
3. Enter the Wikipedia article title or URL.
3. Enter a Wikipedia article title or URL, or use "Find articles by category"
to discover articles that need images.
4. Browse the Flickr search results displayed in the interface.
5. Click on a photo to select it and compose a permission request message.
5. Click on a photo to select it. If the license is Wikipedia-compatible, you'll
be linked to the Commons UploadWizard. Otherwise, a message is composed to
request a license change.
6. Copy the subject and message, then click "Send message on Flickr" to contact
the photographer.
the user.
## Error Handling