GunSpec

Alle 39 Einzel-Tools

Search firearms

  • gunspec_search_firearms
  • Builder
  • Nur lesend

Runs a full-text search over the firearm catalog by name, manufacturer, model number or alias. Use this tool first when the user refers to a firearm informally. Returns matching firearms with the slug ids that the other tools accept. Needs the Builder plan; on Explorer, find records with gunspec_list_firearms filters (maker, cartridge, category, year) instead.

Anwendungsbeispiel

  1. 1

    Eine Person fragt

    • Find firearms matching "steyr f88".
  2. 2

    Der Assistent ruft das Tool auf

    tools/call
    json
    {  "name": "gunspec_search_firearms",  "arguments": {    "q": "steyr f88",    "per_page": 3  }}
  3. 3

    Der Server antwortet

    Ergebnis
    json
    {  "results": [    {      "id": "f88-austeyr",      "name": "F88 Austeyr",      "manufacturer_id": "thales-australia",      "category_id": "assault-rifle",      "manufacturer_name": "Thales Australia",      "category_name": "Assault Rifle",      "category_slug": "assault-rifle",      "year_introduced": 1989,      "status": "in_production",      "country_of_origin": "AU",      "action_type": "gas_operated_short_stroke",      "weight_empty_g": 3600,      "barrel_length_mm": 508,      "svg_line_art_url": "https://api.gunspec.io/v1/firearms/f88-austeyr/media/silhouette",      "model_3d_url": "https://assets.gunspec.io/models/f88-austeyr.glb",      "favorite_count": 0,      "rank": -24.370656157452174,      "matched_name": null,      "matched_name_kind": null,      "images": [        {          "id": 737,          "url": "https://api.gunspec.io/v1/firearms/f88-austeyr/images/737",          "kind": "silhouette",          "alt": null,          "width": null,          "height": null        },        {          "id": 981,          "url": "https://assets.gunspec.io/models/f88-austeyr.glb",          "kind": "model",          "alt": null,          "width": null,          "height": null        },        {          "id": 6459,          "url": "https://api.gunspec.io/v1/firearms/f88-austeyr/images/6459",          "kind": "render",          "alt": "F88 Austeyr assault rifle, left-side profile render",          "width": 1536,          "height": 1024        }      ]    },    {      "id": "thales-f90",      "name": "Thales F90",      "manufacturer_id": "thales-australia",      "category_id": "assault-rifle",      "manufacturer_name": "Thales Australia",      "category_name": "Assault Rifle",      "category_slug": "assault-rifle",      "year_introduced": 2012,      "status": "in_production",      "country_of_origin": "AU",      "action_type": "gas_operated_rotating_bolt",      "weight_empty_g": 3250,      "barrel_length_mm": 407,      "svg_line_art_url": "https://api.gunspec.io/v1/firearms/thales-f90/media/silhouette",      "model_3d_url": null,      "favorite_count": 0,      "rank": -22.657054423312104,      "matched_name": null,      "matched_name_kind": null,      "images": [        {          "id": 735,          "url": "https://api.gunspec.io/v1/firearms/thales-f90/images/735",          "kind": "silhouette",          "alt": null,          "width": null,          "height": null        },        {          "id": 940,          "url": "https://api.gunspec.io/v1/firearms/thales-f90/images/940",          "kind": "silhouette",          "alt": null,          "width": null,          "height": null        },        {          "id": 980,          "url": "https://assets.gunspec.io/models/ef88-austeyr.glb",          "kind": "model",          "alt": null,          "width": null,          "height": null        }      ]    },    {      "id": "steyr-aug-para-9mm",      "name": "Steyr AUG Para 9mm",      "manufacturer_id": "steyr-mannlicher",      "category_id": "submachine-gun",      "manufacturer_name": "Steyr Arms",      "category_name": "Submachine Gun",      "category_slug": "submachine-gun",      "year_introduced": 1988,      "status": "discontinued",      "country_of_origin": "AT",      "action_type": "blowback",      "weight_empty_g": 3000,      "barrel_length_mm": 420,      "svg_line_art_url": "https://api.gunspec.io/v1/firearms/steyr-aug-para-9mm/media/silhouette",      "model_3d_url": null,      "favorite_count": 0,      "rank": -19.155299645871818,      "matched_name": null,      "matched_name_kind": null,      "images": [        {          "id": 34889,          "url": "https://api.gunspec.io/v1/firearms/steyr-aug-para-9mm/images/34889",          "kind": "silhouette",          "alt": null,          "width": null,          "height": null        },        {          "id": 41875,          "url": "https://api.gunspec.io/v1/firearms/steyr-aug-para-9mm/images/41875",          "kind": "render",          "alt": "Steyr AUG Para 9mm submachine gun, left-side profile render",          "width": 1536,          "height": 1024        }      ]    }  ],  "pagination": {    "page": 1,    "limit": 3,    "per_page": 3,    "total": 5,    "totalPages": 2  }}

    Am 22. Okt. 2026 von der Live-API erfasst. Listen und lange Texte sind für die Anzeige gekürzt.

Zugehörige Referenzen

Argumente

  • stringerforderlich

    The search text, e.g. "beretta 92" or "AK-74M".

    Gesendet als
    ?q=
  • integerstandard20

    Items per page, 1 to 100.

    Bereich
    1 – 100
    Gesendet als
    ?per_page=

Jedes Argument wird als der angegebene Parameter an GET /v1/firearms/search gesendet. Dieselbe Anfrage lässt sich also mit deinem Schlüssel direkt an die API stellen, wenn du bestimmen möchtest, was zurückkommt.

json