Commons:Bots/Requests
If you want to run a bot on Commons, you must get permission first. To do so, file a request following the instructions below.
Please read Commons:Bots before making a request for bot permission.
| I | Create a user account (while logged in to your normal account) and user page for the bot
On the bot's userpage, add {{Bot}}, which automatically adds the page to Category:Commons bots. Then add the following information to the bot's userpage (all this is mandatory):
|
|---|---|
| II | Write your program code.
When you put a request at this page, you are expected to be ready for testing. If you are unsure and want to know if your intended bot job will be accepted, please seek community feedback at a suitable venue, e.g. Commons:Village pump. |
| III | Create your bot request:
Add your bot request to the list here:
|
| IV | Test run
Please make a small test run (5–20 edits) to allow other users to review your bot's tasks. (Please do not put your bot in automatic mode until the request is approved!) |
| V | Waiting for approval.
You now need to wait for community approval. A bureaucrat will close the request and will also grant a bot flag, where necessary. Closed requests are moved to Commons:Bots/Archive. |
|
|
Requests made on this page are automatically transcluded in Commons:Requests and votes for wider comment.
Requests for permission to run a bot
[edit]Before making a bot request, please read the new version of the Commons:Bots page. Read Commons:Bots#Information on bots and make sure you have added the required details to the bot's page. A good example can be found here.
When complete, pages listed here should be archived to Commons:Bots/Archive.
Any user may comment on the merits of the request to run a bot. Please give reasons, as that makes it easier for the closing bureaucrat. Read Commons:Bots before commenting.
CorpLoxTradeBot (talk · contribs)
[edit]Operator: Corplox (talk · contributions · Statistics · Recent activity · block log · User rights log · uploads · Global account information)
Bot's tasks for which permission is being sought:
I am requesting permission to operate CorpLoxTradeBot to upload approximately 20,000 original SVG visualizations of international merchandise trade statistics to Wikimedia Commons.
I operate CorpLox (https://corplox.com), a global trade analytics platform. The visualizations are created by CorpLox using UN Comtrade statistics.
The planned collection includes country-level, bilateral and global trade charts, covering merchandise exports and imports, product sectors and other trade indicators.
I propose starting with a small test focused on country-level exports and imports by HS2 product sector for 2025. Further uploads and chart types will be introduced in stages, subject to community approval.
Four examples have already been uploaded using my existing workflow:
The custom Python uploader supports:
- Checking whether a filename already exists on Commons.
- Checking for duplicate file content.
- Preparing descriptive English filenames and descriptions.
- Identifying UN Comtrade as the statistical source and CorpLox as the visualization creator.
- Applying the CC BY 4.0 license.
- Adding appropriate Commons categories.
- Adding verified structured metadata.
- Recording upload results and errors.
The uploader is integrated into my private software infrastructure. I do not intend to publish the source code, but I can explain its technical operation, API interactions, duplicate detection, rate limiting and error handling.
I am openly disclosing my affiliation with CorpLox. The purpose of the uploads is to contribute reusable statistical visualizations for educational and research use, not to promote the platform.
I understand that the proposed collection is large. I am requesting permission to begin with a small supervised test and will follow the community's instructions regarding the scope and conditions of subsequent uploads.
Automatic or manually assisted: Automatic (supervised). Each batch is initiated manually by the operator. I will review the results and remain available to stop the process or correct errors.
Edit type (e.g. Continuous, daily, one time run): Intermittent, manually initiated batches. The initial test will consist of 5–20 edits, or another number recommended by the reviewing community. The planned collection will be uploaded gradually, subject to approval.
Maximum edit rate (e.g. edits per minute): Planned maximum of 4 write operations per minute, including file uploads and metadata edits. The rate limit will be implemented and verified before testing.
Bot flag requested (Y/N): Y
Programming language(s): Python 3, using the MediaWiki Action API.
Corplox (talk) 16:15, 25 September 2026 (UTC)
- Discussion
- Oppose. I can't find any evidence of Corplox being cited in acadamia; and the domain was registered just this year; browsing through the site all the "About X company" blurbs are AI-generated, and no sources are provided each entry. Given that this is a:
- Untested dataset, with
- Dubious verifibility, and
- Questionable licensing
- I do not want 20,000 graphs of this on Commons.
| Questionable licensing |
|---|
Quoting from the TOS of COMTRADE, one of your listed data sources: 5. Usage. United Nations COMTRADE contains copyrighted material and/or other proprietary information. The materials contained on or otherwise made available to you on United Nations COMTRADE may be copyrighted by the United Nations and, thus, are protected by copyright laws and regulations worldwide. Except as may otherwise be expressly permitted by applicable law, any copying, automated browsing or downloading, redistribution, publication, or commercial exploitation of any material contained on or otherwise made available to you on United Nations COMTRADE is strictly prohibited without the prior written permission of the United Nations. I don't see evidence of a prior written permission of the United Nations. OpenCorporates also has attribution rules, which I don't see being followed: The ODbL requires you to attribute your use of our database. This is important as it allows us (and in turn the community) to benefit from reuse of our work, and so allows us to continue to provide this service. Use of any data must be accompanied by a hyperlink reading “from OpenCorporates” and linking to either the OpenCorporates homepage or the page referring to the information in question. The URL for this is returned in most API calls and if you are making use of the API we would expect you to use the latter form. The attribution must be large and clear enough to be clearly associated with the usage, and must in all cases be no smaller than 70% of the largest font relating to the information or 7px , whichever is the larger. If you are making the information available via your own API you need to make sure your users comply with all these conditions, and if the information from OpenCorporates forms the substantial part of the web-page, you should use the rel-canonical tag to indicate to search engines that the OpenCorporates page for the company is the core page for this topic. "Official business and corporate registries" is also delightfully vague for a source. |
msk 16:48, 25 September 2026 (UTC)
- Thank you for reviewing my request and raising these concerns.
- I would like to clarify several points.
- 1. Data sources and verifiability
- The proposed trade charts are based on UN Comtrade statistics. CorpLox is the creator of the visualizations, not the original publisher of the underlying trade statistics.
- The proposed upload collection is separate from the company-information section of the CorpLox website.
- I understand the concern about verifiability. I can provide the specific UN Comtrade data sources, query parameters and calculation methodology for representative charts so that their results can be independently checked.
- 2. OpenCorporates
- OpenCorporates is not a data source for the proposed international trade charts.
- I understand that you have also raised concerns about other sections of the CorpLox website. However, those company-information pages are not included in the proposed Wikimedia Commons uploads.
- 3. UN Comtrade licensing
- UN Comtrade's published policy distinguishes between redistribution of original datasets and substantially transformed data. Its documentation also identifies certain exemptions for publishing small numbers of graphs.
- I recognize that these provisions do not automatically establish permission for the proposed large collection. I will not claim that the entire collection qualifies for an exemption without establishing the applicable conditions.
- 4. Proposed upload volume
- The figure of approximately 20,000 files represents the potential size of the collection, not an intention to upload everything immediately.
- I understand that such a large contribution requires additional scrutiny, particularly regarding licensing, verifiability and the usefulness of individual charts.
- I will pause further bot uploads while these concerns remain unresolved.
- I would appreciate feedback on the specific source documentation and methodological information that would be useful for assessing the existing examples.
- Thank you for your time. Corplox (talk) 17:06, 25 September 2026 (UTC)
- I am a human being, and I would like to communicate to you as a human being, not your chatbot.
- "I violated copyright, but I'm not uploading those specific files to Commons" is not all that convincing of an argument. Who would've thought?
- Could I also get a administrator to procedurally close this BRFA for being AI-generated? Thanks. msk 17:35, 25 September 2026 (UTC)
- I understand your concerns.
- I used AI to help formulate my previous response, but I am personally responsible for this project and the proposed uploads.
- I have not stated that I violated copyright, and I would appreciate it if my position were not misrepresented. Corplox (talk) 17:45, 25 September 2026 (UTC)
- I think data tables are much better solution, since charts may be localized at use place. Sure, if data is taken from reliable sources. --EugeneZelenko (talk) 15:08, 28 September 2026 (UTC)
Operator: 7804j (talk · contributions · Statistics · Recent activity · block log · User rights log · uploads · Global account information)
Bot's tasks for which permission is being sought: Batch uploads of freely licensed and public-domain media collections held by public institutions, with their descriptive metadata, on behalf of OKA.wiki (Open Knowledge Association), a non-profit that supports Wikimedia projects. Many public collections are free of rights but hard to find and missing from Commons; the aim is to bring them in with good descriptions, categories and locations.
- First source: swisstopo terrestrial images. About 57,000 scanned black-and-white terrestrial survey photographs from the Swiss Federal Office of Topography, fetched through the swisstopo STAC API (data.geo.admin.ch). License {{Attribution-Swisstopo}}; swisstopo confirmed by email that they agree to the upload of the full collection. Example of the file page format: File:St. Gotthard - Piz Ner West - Swisstopo 164358.tif (St. Gotthard survey, 1917). ((project briefly discussion at village pump about a year ago)
- All description data comes from the source metadata for each image: date, survey area and station, inventory number, camera, focal length, plate format, camera position and heading ({{Location}}), and the image footprint ({{Object location}}).
- Categories: Category:Photographs by swisstopo, year, canton by year or decade (worked out from the footprint), and the hidden tracking category Category:Photos uploaded by OKA.wiki.
- The built-in reduced-resolution overviews of the source TIFFs are removed before upload, without re-encoding; the full-resolution image data is copied unchanged.
- Future sources. Other free collections, following the same approach. Partnerships with Wikimedia CH and cantonal institutions such as libraries are being discussed.
Automatic or manually assisted: Automatic, supervised. Uploads run in batches; each batch is checked before the next one starts, and the run stops on any error.
Edit type (e.g. Continuous, daily, one time run): One-time runs per collection, in batches (for swisstopo: first 100 files, then the rest), plus occasional follow-up fixes.
Maximum edit rate (e.g. edits per minute): up to 4 per second. In practice, typically much lower to spread upload of a collection over multiple days
Bot flag requested: (Y/N): Y (to lift the upload rate limit and keep the uploads out of watchlists)
Programming language(s): Python (Pywikibot)
7804j (talk) 08:42, 24 September 2026 (UTC)
- Discussion
- Please make test run. --EugeneZelenko (talk) 12:49, 26 September 2026 (UTC)
- Sure! I've uploaded 10 images, see below.
- File:St. Gotthard - Furkaegg - Swisstopo 164359.tif (1915, Uri)
- File:St. Gotthard - Blauberg West Grat - Swisstopo 164361.tif (1915, Ticino)
- File:St. Gotthard - Blauberg - Swisstopo 164365.tif (1915, Uri)
- File:St. Gotthard - Vormigel West A-B - Swisstopo 164493.tif (1915, Uri)
- File:St. Gotthard - Alp Tgom - Swisstopo 164754.tif (1916, Graubünden)
- File:St. Gotthard - Alpe Farre West A-B (Tamaro) - Swisstopo 164655.tif (1916, Ticino)
- File:Bergell - Piz Lizun Ost - Swisstopo 166094.tif (1920, Graubünden)
- File:Amt Frutigen - Kühweid - Swisstopo 170040.tif (1926, Bern)
- File:Simplon - Hübschhorn West - Swisstopo 345839.tif (1929, Valais)
- File:Simplon - Wängenhorn Nord - Swisstopo 345847.tif (1929, Valais)
- 7804j (talk) 16:12, 26 September 2026 (UTC)
- Please use language tags for photographer, title and depicted place. Are there templates with localization that could be used in medium? EugeneZelenko (talk) 14:43, 27 September 2026 (UTC)
- Thanks for the suggestions! Please take a look. I have also added more specific categories. I will also review all existing files on Commons from Swisstopo to ensure they are consistently categorized after my upload 7804j (talk) 15:54, 27 September 2026 (UTC)
- Looks OK for me. And Wikidata items are definitely better than my original suggestion! EugeneZelenko (talk) 15:06, 28 September 2026 (UTC)
- Thanks! What are the next steps, can I proceed with uploading or does it need additional approvals? 7804j (talk) 15:53, 28 September 2026 (UTC)
- Ah sorry just saw it requires closure by a bureaucrat, so will wait for more people to chime in 7804j (talk) 18:50, 28 September 2026 (UTC)
- Thanks! What are the next steps, can I proceed with uploading or does it need additional approvals? 7804j (talk) 15:53, 28 September 2026 (UTC)
- Looks OK for me. And Wikidata items are definitely better than my original suggestion! EugeneZelenko (talk) 15:06, 28 September 2026 (UTC)
- Thanks for the suggestions! Please take a look. I have also added more specific categories. I will also review all existing files on Commons from Swisstopo to ensure they are consistently categorized after my upload 7804j (talk) 15:54, 27 September 2026 (UTC)
- Please use language tags for photographer, title and depicted place. Are there templates with localization that could be used in medium? EugeneZelenko (talk) 14:43, 27 September 2026 (UTC)
- Sure! I've uploaded 10 images, see below.
Operator: MSK (talk · contributions · Statistics · Recent activity · block log · User rights log · uploads · Global account information)
Bot's tasks for which permission is being sought: Diffuse Category:La Patria del Friuli, requested here
Automatic or manually assisted: Automatic
Edit type (e.g. Continuous, daily, one time run): one time run
Maximum edit rate (e.g. edits per minute): 6epm
Bot flag requested: (Y/N): N
Programming language(s): Pywikibot, again. See https://public-paws.wmcloud.org/User:MSK/La%20Patria%20del%20Friuli%20cleanup.ipynb for source.
msk 00:08, 22 September 2026 (UTC)
- (The way it is written means that test edits aren't really possible, however the code is incredibly simple so that shouldn't be an issue.) msk 00:12, 22 September 2026 (UTC)
- Discussion
- Please make test run. By the word, request for reupload files task should be also filed. --EugeneZelenko (talk) 15:11, 22 September 2026 (UTC)
- The reupload task wasn't filed in the interest of avoiding the streisand effect, since bot requests are highly visible and thus would draw unwanted attention to the personal information. msk 17:09, 22 September 2026 (UTC)
Some example edits during the dry run:
File:La Patria del Friuli 1888-07-20 (IA LaPatriadelFriuli1887-201).pdf: -> [[Category:La Patria del Friuli (1888)]]
@@ -26 +26 @@ ***
- [[Category:La Patria del Friuli]] ***
+ [[Category:La Patria del Friuli (1888)]] ***
File:La Patria del Friuli 1888-07-21 (IA LaPatriadelFriuli1887-202).pdf: -> [[Category:La Patria del Friuli (1888)]]
@@ -26 +26 @@ ***
- [[Category:La Patria del Friuli]] ***
+ [[Category:La Patria del Friuli (1888)]] ***
File:La Patria del Friuli 1888-07-22 (IA LaPatriadelFriuli1887-203).pdf: -> [[Category:La Patria del Friuli (1888)]]
@@ -26 +26 @@ ***
- [[Category:La Patria del Friuli]] ***
+ [[Category:La Patria del Friuli (1888)]] ***
msk 18:30, 22 September 2026 (UTC)
- @EugeneZelenko dry run examples are above. msk 18:46, 23 September 2026 (UTC)
- Looks OK for me. EugeneZelenko (talk) 15:03, 24 September 2026 (UTC)
BSupload Bot (talk · contribs)
[edit]Operator: Armin hpj (talk · contributions · Statistics · Recent activity · block log · User rights log · uploads · Global account information)
Bot's tasks for which permission is being sought: Automatically uploads the additional colors of the BSicons.
Automatic or manually assisted: Automatic
Edit type (e.g. Continuous, daily, one time run): Continuous
Maximum edit rate (e.g. edits per minute):
Bot flag requested: (Y/N): Yes
Programming language(s): Python
Armin hpj (talk) 11:56, 11 September 2026 (UTC)
- Discussion
- Please make test run. --EugeneZelenko (talk) 15:04, 11 September 2026 (UTC)
- Please pay very careful attention to categorisation, utilising color name sub-categories where appropriate, and avoid uploading large numbers of BSicons to "other colors" categories. Redlinked categories should be created with the relevant template when new BSicons are added to them. A full description should be included and not just "colored icon for BSicon diagrams" or similar. Creating and uploading the BSicons is only a small part of the task, and the bot should include every aspect in its scope without leaving additional work for other editors. -=# Amos E Wolfe talk #=- 01:51, 12 September 2026 (UTC)
- The first edit is not related to the test --Armin hpj (talk) 23:32, 12 September 2026 (UTC)
- Following your recent test uploads, you need to look at some of the settings of the Bot. For example there is no "set ex" — icons with that prefix are simply out of service variants of the default set. Likewise "set uex" are part of "set u" and not their own color set.
- As per my earlier comment, when uploading these files, a number of redlinked categories need to be created by adding
{{BS-category}}and saving with an edit summary. This needs to be completed by the Bot as soon as a file is uploaded and added to a category that does not yet exist. Please do not rely on other editors to clean up after your Bot. - You have added the description Colored variant of the BSicon KRZ3+1o+l icon which is not descriptive of the content of the BSicon itself. In this example the default color BSicon has the description Crossing through over line to corner 3 from corner 1, with connection from left which should be simple enough to copy and paste manually, or scrape from the relevant template in the file's description, and have the Bot add (with variants for set name and e / x / ex status) at the time of upload.
- Having the Bot's output be clean, concise, accurate, and not requiring manual revision by other editors is more important than any speed advantage the Bot may or may not confer. Please consider carefully whether running a Bot is the best use case for the task at hand, which may be better suited to semi-automated tools such as the Python script by User:SomeRailFan running on your local machine, followed by batch-uploading using Pattypan. -=# Amos E Wolfe talk #=- 02:29, 13 September 2026 (UTC)
- Thank you for saying this. If this bot has been approved, before I run it, I will edit it's scripts (for example, it automatically adds "<color> version of " before the English description and... ) Armin hpj (talk) 11:19, 13 September 2026 (UTC)