Gun & Ammo Title Parser

Turn gun and ammo product titles into structured data without leaving the editor: brand, model, generation, caliber, magazine capacity, barrel length, rounds per box and cost per round. Made for people who build product feeds, imports and catalogs for gun and ammo stores, and who spend their days in CSV exports, JSON feeds and SQL dumps full of titles like G19 GEN5 9MM 15RD FS.

Select some lines and run GunsNPrices: Parse Selected Titles from the Command Palette:

Glock 19 Gen 5 MOS 9mm 4.02" 15rd Pistol PA195S203MOS
Federal American Eagle 9mm Luger 115gr FMJ 50 Rounds $18.99
Ruger 10/22 Carbine .22 LR 18.5" 10rd
Winchester 9mm 115gr FMJ 1000 Round Case - $289.99

A new editor opens with the result:

Everything runs on your machine. The extension makes no network requests, collects no telemetry and needs no account or API key. The parsing is done by gunsnprices, the open source title parser behind the price comparison site GunsNPrices, so you get the same model and caliber names the site uses to group listings from 40+ US stores.

Commands

Parse Selected Titles

Each selected line is read according to what it looks like:

The JSON output has the fields of the parser's ProductInfo plus the source line and the price that was found:

{
  "line": 2,
  "title": "Federal American Eagle 9mm Luger 115gr FMJ 50 Rounds",
  "kind": "ammo",
  "brand": "",
  "model": null,
  "caliber": { "id": "9x19mmparabellum", "name": "9×19mm Parabellum", "type": "handgun" },
  "calibers": [{ "id": "9x19mmparabellum", "name": "9×19mm Parabellum", "type": "handgun" }],
  "capacity": null,
  "barrelLength": null,
  "rounds": 50,
  "price": 18.99,
  "costPerRound": 0.3798
}

The CSV output has these columns (several values in one cell are separated by ; ):

line,title,kind,brand,model,family,generation,configs,features,caliber,caliber_type,calibers,capacity,barrel_in,rounds,price,cost_per_round
1,"Glock 19 Gen 5 MOS 9mm 4.02"" 15rd Pistol PA195S203MOS",firearm,Glock,Glock 19 Gen 5 MOS,Glock 19,5,MOS,,9×19mm Parabellum,handgun,9×19mm Parabellum,15,4.02,,,
2,Federal American Eagle 9mm Luger 115gr FMJ 50 Rounds,ammo,,,,,,,9×19mm Parabellum,handgun,9×19mm Parabellum,,,50,18.99,0.3798

To parse a whole file, select all (Ctrl+A / Cmd+A) first. Selections over 2,000 lines show a progress notification and can be cancelled.

Normalize Caliber

Select a caliber, or a column of them (one per line, or with several cursors), and run GunsNPrices: Normalize Caliber:

The names come from a list of 293 calibers. Quotes and spaces around the value are kept. Text that isn't recognized is left as it is, and so is text that is more than a caliber (a whole title, or 9mm / .380), so selecting too much never loses data; a message lists what was left. Turn on gunsnprices.asciiCaliberNames to get 9x19mm Parabellum instead of 9×19mm Parabellum.

Cost per Round

Asks for the price of the box or case, then for the number of rounds or a title that contains it (50 Rounds, 1000rd case, 20/box). When the cursor is on a line with a title and a price, both are filled in for you. The result can be copied:

$289.99 for 1000 rounds = $0.29 (29.00¢) per round

Hover

Hover a line, a CSV cell or a JSON string that looks like a gun or ammo title to see what the parser reads from it:

Glock 19 Gen 5 MOS · firearm
- Brand: Glock
- Family: Glock 19
- Generation: 5
- Configuration: MOS
- Caliber: 9×19mm Parabellum (handgun)
- Capacity: 15 rounds
- Barrel: 4.02 in

Ammo with a price in the same line or row also shows the cost per round, and a cell or string that is just a caliber ("caliber": "9mm Luger") shows its standard name. Lines that merely contain a number that could be a caliber (call me at 308 tomorrow) are ignored.

The hover is on in CSV, TSV, plain text, JSON, JSON Lines and Markdown files, and off in every other language. Change that with gunsnprices.hover.languages, or turn it off with gunsnprices.hover.enabled.

Settings

What it recognizes

Brands with model dictionaries include Glock, Sig Sauer, Smith & Wesson, Ruger, Springfield, Taurus, Mossberg, Remington, Beretta, Benelli, Browning, Winchester, CZ, FN, HK, Henry, Marlin, Savage, Tikka, Walther and 30 more; the full list is in the gunsnprices README. The same parser is available for Node.js and browsers and Python, with identical results, if you want to run it in your feed pipeline.

Privacy

The extension reads only the text you select or hover, in memory. It sends nothing anywhere: there is no telemetry and no network code. With gunsnprices.links turned on, caliber names become ordinary links that open in your browser when you click them.

Requirements

VS Code 1.85 or newer. The extension only reads text that is open in the editor, so it also runs in untrusted, remote and virtual workspaces.

License

MIT. The model and caliber data come from the gunsnprices package (CC BY 4.0, attribution: GunsNPrices).