onet

o*net (u.s. department of labor)

onet.

A US occupation in the O*NET taxonomy — find it, or read its profile.

ajouter à otoauth : —prefix : onet_*

setup & usage

⚠ o*net web services api key

create a free developer account on services.onetcenter.org (Sign up), generate a key in My Account, then paste it into oto.

  • byo-only: no shared oto key — the key is personal, its terms of use are accepted by its holder
  • no hard cap announced, but a 429 when the service is saturated: retry after a short delay
  • ▸ find a us occupation and read its record

    the Department of Labor's occupation reference, in one tool:

  • "what is the code for the data engineer occupation?" → onet_occupation(op="search", keyword="data engineer") — closest first; a code, even partial, can also be searched (keyword="15-12")
  • "what does a civil engineer do?" → onet_occupation(op="get", code="17-2051.00") — title, description, job titles actually encountered (sample_of_reported_titles), tasks (tasks, limit widens their number), related detailed occupations (also_see)
  • · ⚠️ codes and limits
  • an O\*NET-SOC code has 8 digits (15-1299.08); its first 6 (15-1299) are the SOC code under which US wage statistics are published — several O\*NET occupations therefore share the same wage figures
  • not every occupation carries every field: an occupation without tasks returns tasks: [], it is not an error
  • full=True additionally returns the API's navigation links (useless to an agent, removed by default)
  • written from the v2.0 reference manual, not yet exercised live (no key available at the time of writing): on first real use, report any shape discrepancy
  • ⚙ multiple comptes

    this connector accepts multiple comptes: each stored credential becomes a named account (one name per compte), at your level, your team's or your org's.

  • the first one doesn't need a name; from the second on, each one carries its own (the first then takes the name "principal", renamable)
  • without specification, the agent takes the only stored compte, otherwise the one marked as default; otherwise the call is refused, naming the available comptes — never a random choice
  • target a compte for a call: _account="<name>" on the tool; list them: oto_identity(op='list', connector='onet') (scope='org' or scope='group' for the org's or team's)
  • set the default: oto_identity(op='set', connector='onet', identity_id='<name>'); rename: op='rename' with new_name
  • ⚠️ no tool walks through the comptes on its own: a total across several comptes is obtained by calling each one (_account) and adding up
  • outils

    chargement…

    utilisation

    claude code — installe le plugin oto — claude plugin marketplace add otomata-tech/oto-plugin — mcp + skill configurés.
    claude.ai — branche mcp.oto.cx/mcp en connecteur custom (guide)
    cli — pipx install oto-cli puis oto onet …