NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Moz connects to a Nagent workspace with an API key. Once it is connected, agents can call 12 Moz actions, such as "Get Global Top Root Domains", "Get API Usage Data" and "Get Global Top Pages". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Moz, with input parameters and output schema.
MOZ_FETCH_METADATA_INDEXTool to fetch current index metadata from Moz via JSON-RPC. Returns an index ID that changes when the data in the index is updated. Use when you need to track index updates or verify the current index state.
Input parameters
Optional unique identifier for the JSON-RPC request (min 24 chars). If not provided, a UUID will be generated automatically.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MOZ_FETCH_SITE_METRICSTool to fetch site metrics from Moz including Domain Authority, Page Authority, Spam Score, and link counts. Use when you need SEO metrics for a domain or specific URL. Returns comprehensive link and authority data.
Input parameters
Unique identifier for the JSON-RPC request (min 24 characters). Auto-generated if not provided.
Site query parameters containing the target domain/URL and scope.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MOZ_GET_GLOBAL_TOP_ROOT_DOMAINSTool to get the top 500 root domains across the entire web index sorted by Domain Authority. Returns the highest authority domains globally with Domain Authority, Spam Score, and linking domains count. Use when you need to identify the most authoritative domains on the web.
Input parameters
Maximum number of results to return (1-500). Controls how many top domains are included in the response.
Cursor for fetching the next set of results from a previous request. If set, return the next page of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MOZ_GET_USAGE_DATATool to get API usage data including the number of rows consumed. Use when you need to track API usage for a specific time range or the current billing period.
Input parameters
End of time period in Unix time (seconds since 1970-01-01 UTC). Default is current time.
Start of time period in Unix time (seconds since 1970-01-01 UTC). Default is start of current month.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MOZ_GLOBAL_TOP_PAGESTool to fetch global top pages from Moz. Use when you need a paginated list of highest authority pages.
Input parameters
Maximum number of results to return (1-50). Defaults to server default when omitted.
Cursor for fetching the next page of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MOZ_INDEX_METADATATool to fetch link index metadata from Moz. Use when you need the current index ID (which changes when the index updates) and the dates of Spam Score model updates. Use after authenticating with Moz API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MOZ_LINK_STATUSTool to check if source URLs link to a target URL. Use when you need to verify inbound links from multiple sources to a target.
Input parameters
The target URL to check inbound links against.
List of source URLs to test linking to the target (1 to 50 URLs).
Scope for the source URLs: one of 'page', 'subdomain', or 'root_domain'. If omitted, defaults to 'page'.
Scope for the target URL: one of 'page', 'subdomain', or 'root_domain'. If omitted, defaults to 'page'. Broader scopes ('subdomain', 'root_domain') match links across more URLs than intended and can produce false positives when verifying a specific page-level link.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MOZ_LIST_GLOBAL_TOP_DOMAINSTool to get the top ranking domains globally based on Domain Authority. Use when you need the highest authority domains in the entire Moz index.
Input parameters
Number of results to return. Defaults to 50 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MOZ_LIST_GLOBAL_TOP_PAGESTool to fetch global top ranking pages from Moz using JSON-RPC API. Use when you need to retrieve the highest Page Authority pages in the entire Moz index.
Input parameters
Number of results to return. Defaults to 50 if not specified.
Number of results to skip for pagination. Defaults to 0 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MOZ_LOOKUP_QUOTATool to lookup API quota information including remaining rows, quota limits, and usage across different quota types. Use when you need to check current quota status without consuming quota.
Input parameters
Quota path to lookup. Common paths: 'api.limits.data.rows' for data row quota, 'api.limits.beta.rows' for beta row quota, 'api.limits.mozscape.rows' for mozscape quota.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MOZ_POST_TOP_PAGESTool to fetch the top pages on a target domain from Moz. Top pages are identified as pages with the most external links. Use when you need a list of high-authority pages on a specific domain or subdomain, sorted by Page Authority or other metrics.
Input parameters
The sort order for results. Common values: 'page_authority' (default), 'domain_authority', 'external_pages_to_page'. Prefix with '-' for descending order (e.g., '-page_authority').
Maximum number of results to return (1-1000). Defaults to server default when omitted.
The scope of the query. Options: 'page', 'subdomain', or 'root_domain'. Defaults to 'page' if omitted.
Filter for results based on HTTP status codes. Example: 'http_code:200' to only include pages with HTTP 200 status.
The domain or URL to query for top pages.
Pagination token for fetching the next page of results. Use the 'next_token' value from a previous response.
Array of strings specifying daily history delta metrics to include in the response.
Array of strings specifying daily history value metrics to include in the response.
Array of strings specifying monthly history delta metrics to include in the response.
Array of strings specifying monthly history value metrics to include in the response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MOZ_USAGE_DATATool to fetch API usage and quota details from Moz. Use when you need to monitor current plan, quota usage, and rate limits.
Input parameters
Optional target URL when probing anchor_text or url_metrics.
Specific resource type label, e.g., 'url_metrics'.
Timeframe hint (used for labeling only).
Which endpoint to probe to extract usage headers.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 12 Moz actions on Nagent, including "Get Global Top Root Domains", "Get API Usage Data" and "Get Global Top Pages". Get Global Top Root Domains: Get the top 500 root domains across the entire web index sorted by Domain Authority. Each action is listed on this page with its input parameters and its output.
Moz connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It also takes 2 optional inputs: limit and next_token. It returns data, error and successful.