Ebird Taxonomy Tools

Configuration File: ebird_taxonomy_tools.json Tool Type: Local Tools Count: 2

This page contains all tools defined in the ebird_taxonomy_tools.json configuration file.

Available Tools

eBird_get_taxon_groups (Type: BaseRESTTool)

Get the list of bird taxonomic groups from eBird (Cornell Lab of Ornithology). Returns all bird g…

eBird_get_taxon_groups tool specification

Tool Information:

  • Name: eBird_get_taxon_groups

  • Type: BaseRESTTool

  • Description: Get the list of bird taxonomic groups from eBird (Cornell Lab of Ornithology). Returns all bird groups (e.g., Waterfowl, Raptors, Owls, Hummingbirds, Woodpeckers, Sparrows) with their taxonomic order bounds. Two grouping systems are available: ‘merlin’ (simplified groups used in the Merlin Bird ID app, ~30 groups) and ‘ebird’ (full eBird taxonomy groups, ~217 groups). Each group has a name, display order, and taxon order bounds that map to species in the full taxonomy. Useful for categorizing species into familiar bird groups. Can be localized to different languages. No API key required.

Parameters:

  • speciesGrouping (string) (required) Grouping system to use. ‘merlin’ returns ~30 simplified groups used in the Merlin Bird ID app (Waterfowl, Hawks/Eagles, Owls, Hummingbirds, etc.). ‘ebird’ returns ~217 detailed taxonomic groups (Ostriches, Kiwis, Ducks/Geese/Swans, etc.).

  • groupNameLocale ([‘string’, ‘null’]) (optional) Language code for group names (e.g., ‘en’ for English, ‘es’ for Spanish, ‘fr’ for French, ‘de’ for German). Defaults to ‘en’.

Example Usage:

query = {
    "name": "eBird_get_taxon_groups",
    "arguments": {
        "speciesGrouping": "example_value"
    }
}
result = tu.run(query)

eBird_get_taxonomy (Type: BaseRESTTool)

Get bird taxonomy data from eBird (Cornell Lab of Ornithology). Returns taxonomic information inc…

eBird_get_taxonomy tool specification

Tool Information:

  • Name: eBird_get_taxonomy

  • Type: BaseRESTTool

  • Description: Get bird taxonomy data from eBird (Cornell Lab of Ornithology). Returns taxonomic information including scientific name, common name, species code, taxonomic order, family, and banding codes. Can retrieve taxonomy for a specific species by code, filter by taxon type, or set locale for common names in different languages. Without parameters, returns the complete eBird taxonomy (~17,000 taxa). Use species codes like ‘amerob’ (American Robin), ‘baleag’ (Bald Eagle), ‘mallar3’ (Mallard). No API key required.

Parameters:

  • species ([‘string’, ‘null’]) (optional) eBird species code to filter to a single species (e.g., ‘amerob’ for American Robin, ‘baleag’ for Bald Eagle, ‘mallar3’ for Mallard, ‘pilwoo’ for Pileated Woodpecker). Find codes via eBird website or search.

  • taxonType ([‘string’, ‘null’]) (optional) Taxonomic category filter. Values: ‘species’ (full species only), ‘issf’ (identifiable sub-specific forms), ‘spuh’ (genus-level), ‘slash’ (species pairs), ‘intergrade’, ‘domestic’, ‘hybrid’, ‘form’

  • locale ([‘string’, ‘null’]) (optional) Language code for common names (e.g., ‘en’ for English, ‘es’ for Spanish, ‘fr’ for French, ‘de’ for German, ‘zh’ for Chinese). Defaults to ‘en’.

Example Usage:

query = {
    "name": "eBird_get_taxonomy",
    "arguments": {
    }
}
result = tu.run(query)