KosmoKrator

data

reCAPTCHA CLI for AI Agents

Use the reCAPTCHA CLI from KosmoKrator to call reCAPTCHA tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

reCAPTCHA CLI Setup

reCAPTCHA can be configured headlessly with `kosmokrator integrations:configure recaptcha`.

Install, configure, and verify
# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure recaptcha --enable --read allow --write ask --json
kosmokrator integrations:doctor recaptcha --json
kosmokrator integrations:status --json

Credentials

Authentication type: No credentials none. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

No credentials are required.

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call
kosmo integrations:call recaptcha.recaptcha_list_assessments '{"parent":"example_parent","page_size":1,"page_token":"example_page_token"}' --json
Provider shortcut
kosmo integrations:recaptcha recaptcha_list_assessments '{"parent":"example_parent","page_size":1,"page_token":"example_page_token"}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands
kosmo integrations:docs recaptcha --json
kosmo integrations:docs recaptcha.recaptcha_list_assessments --json
kosmo integrations:schema recaptcha.recaptcha_list_assessments --json
kosmo integrations:search "reCAPTCHA" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

recaptcha.recaptcha_list_assessments

List reCAPTCHA Enterprise assessments for a Google Cloud project. Returns assessment names, scores, token properties, and event details. Supports pagination with page size and page token.

Read read
Parameters
parent, page_size, page_token
Generic call
kosmo integrations:call recaptcha.recaptcha_list_assessments '{"parent":"example_parent","page_size":1,"page_token":"example_page_token"}' --json
Shortcut
kosmo integrations:recaptcha recaptcha_list_assessments '{"parent":"example_parent","page_size":1,"page_token":"example_page_token"}' --json

recaptcha.recaptcha_get_assessment

Get a single reCAPTCHA Enterprise assessment by its full resource name. Returns the score, token properties, event details, and risk analysis.

Read read
Parameters
name
Generic call
kosmo integrations:call recaptcha.recaptcha_get_assessment '{"name":"example_name"}' --json
Shortcut
kosmo integrations:recaptcha recaptcha_get_assessment '{"name":"example_name"}' --json

recaptcha.recaptcha_create_assessment

Create a reCAPTCHA Enterprise assessment to evaluate a reCAPTCHA token. Provide the project parent, the token to evaluate, and the site key. Returns score, token validity, and action verification.

Write write
Parameters
parent, token, site_key, expected_action, hashed_account_id
Generic call
kosmo integrations:call recaptcha.recaptcha_create_assessment '{"parent":"example_parent","token":"example_token","site_key":"example_site_key","expected_action":"example_expected_action","hashed_account_id":"example_hashed_account_id"}' --json
Shortcut
kosmo integrations:recaptcha recaptcha_create_assessment '{"parent":"example_parent","token":"example_token","site_key":"example_site_key","expected_action":"example_expected_action","hashed_account_id":"example_hashed_account_id"}' --json

recaptcha.recaptcha_list_keys

List reCAPTCHA Enterprise site keys for a Google Cloud project. Returns key names, display names, web settings, and integration type. Supports pagination.

Read read
Parameters
parent, page_size, page_token
Generic call
kosmo integrations:call recaptcha.recaptcha_list_keys '{"parent":"example_parent","page_size":1,"page_token":"example_page_token"}' --json
Shortcut
kosmo integrations:recaptcha recaptcha_list_keys '{"parent":"example_parent","page_size":1,"page_token":"example_page_token"}' --json

recaptcha.recaptcha_get_key

Get a reCAPTCHA Enterprise site key by its full resource name. Returns the key configuration including web, Android, and iOS settings.

Read read
Parameters
name
Generic call
kosmo integrations:call recaptcha.recaptcha_get_key '{"name":"example_name"}' --json
Shortcut
kosmo integrations:recaptcha recaptcha_get_key '{"name":"example_name"}' --json

recaptcha.recaptcha_list_annotations

List annotations for a reCAPTCHA Enterprise assessment. Annotations provide feedback on assessment results (LEGITIMATE, FRAUDULENT, etc.) to improve model accuracy. Supports pagination.

Read read
Parameters
parent, page_size, page_token
Generic call
kosmo integrations:call recaptcha.recaptcha_list_annotations '{"parent":"example_parent","page_size":1,"page_token":"example_page_token"}' --json
Shortcut
kosmo integrations:recaptcha recaptcha_list_annotations '{"parent":"example_parent","page_size":1,"page_token":"example_page_token"}' --json

recaptcha.recaptcha_get_current_user

Get information about the current reCAPTCHA Enterprise API access. Returns the list of accessible projects to verify connectivity.

Read read
Parameters
none
Generic call
kosmo integrations:call recaptcha.recaptcha_get_current_user '{}' --json
Shortcut
kosmo integrations:recaptcha recaptcha_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

recaptcha.recaptcha_list_assessments 3 parameters
Schema command
kosmo integrations:schema recaptcha.recaptcha_list_assessments --json
ParameterTypeRequiredDescription
parent string yes The project resource name, e.g. "projects/my-project".
page_size integer no Maximum number of assessments to return per page (default: 50, max: 100).
page_token string no Page token from a previous list response to fetch the next page.
recaptcha.recaptcha_get_assessment 1 parameters
Schema command
kosmo integrations:schema recaptcha.recaptcha_get_assessment --json
ParameterTypeRequiredDescription
name string yes The full assessment resource name, e.g. "projects/my-project/assessments/12345678".
recaptcha.recaptcha_create_assessment 5 parameters
Schema command
kosmo integrations:schema recaptcha.recaptcha_create_assessment --json
ParameterTypeRequiredDescription
parent string yes The project resource name, e.g. "projects/my-project".
token string yes The reCAPTCHA token to evaluate (obtained from the client-side widget).
site_key string yes The reCAPTCHA Enterprise site key associated with the token.
expected_action string no The expected action name for action-based verification (e.g. "LOGIN", "SIGNUP").
hashed_account_id string no Optional hashed user account ID for account defender assessment.
recaptcha.recaptcha_list_keys 3 parameters
Schema command
kosmo integrations:schema recaptcha.recaptcha_list_keys --json
ParameterTypeRequiredDescription
parent string yes The project resource name, e.g. "projects/my-project".
page_size integer no Maximum number of keys to return per page (default: 50, max: 100).
page_token string no Page token from a previous list response to fetch the next page.
recaptcha.recaptcha_get_key 1 parameters
Schema command
kosmo integrations:schema recaptcha.recaptcha_get_key --json
ParameterTypeRequiredDescription
name string yes The full key resource name, e.g. "projects/my-project/keys/my-key-id".
recaptcha.recaptcha_list_annotations 3 parameters
Schema command
kosmo integrations:schema recaptcha.recaptcha_list_annotations --json
ParameterTypeRequiredDescription
parent string yes The assessment resource name, e.g. "projects/my-project/assessments/12345678".
page_size integer no Maximum number of annotations to return per page (default: 50, max: 100).
page_token string no Page token from a previous list response to fetch the next page.
recaptcha.recaptcha_get_current_user 0 parameters
Schema command
kosmo integrations:schema recaptcha.recaptcha_get_current_user --json
ParameterTypeRequiredDescription
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.