find_companies

Discover companies from public web sources matching an industry, location, size and/or keyword criteria, returning cited candidate companies (never fabricated) with a stated confidence score.

When to use

Use when an agent needs to discover a list of candidate companies matching criteria (industry, location, size, keywords) rather than analyze one already-known company.

Selection guidance

Role: supporting. Use when an agent needs to discover a list of candidate companies matching criteria (industry, location, size, keywords) rather than analyze one already-known company.

Use cases

• find companies in an industry or location
• build a prospect/lead list
• market landscape scan
• shortlist potential partners or suppliers by criteria

Access

• REST: POST https://api.rafidsystem.com/api/v1/intelligence/find-companies
• x402: POST https://api.rafidsystem.com/api/v1/x402/intelligence/find-companies
• MCP tool: find_companies

Price: $0.05 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.

Related tools

• business_risk_score
• company_reputation_check
• research_company
• company_risk_batch
• company_risk_report
• due_diligence_oman_company
• analyze_company_risk

Example input

{
  "industry": "renewable energy",
  "country": "Germany",
  "limit": 10
}

Example output

{
  "companies": [],
  "resultCount": 0,
  "sources": [],
  "confidence": 0,
  "cached": false,
  "dataMode": "not_configured",
  "requestedLimit": 10,
  "appliedLimit": 0,
  "limitations": [
    "No web search provider is configured for this deployment (WEB_SEARCH_PROVIDER is not set) — no discovery search was performed.",
    "Company discovery is based on public web search coverage — it cannot guarantee completeness, especially for small, private, or newly founded companies with limited public presence.",
    "A company not appearing in these results is not evidence that it doesn't exist or doesn't match the criteria — only that it wasn't found by this search."
  ]
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "industry": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "country": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "city": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "employeeMin": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000
    },
    "employeeMax": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000
    },
    "keywords": {
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 60
      }
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "limit"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "companies": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "website": {
            "type": [
              "string",
              "null"
            ]
          },
          "industry": {
            "type": [
              "string",
              "null"
            ]
          },
          "location": {
            "type": "object",
            "properties": {
              "country": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "city": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "country",
              "city"
            ],
            "additionalProperties": false
          },
          "employeeRange": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "whyMatched": {
            "type": "string"
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "title": {
                  "type": "string"
                },
                "publisher": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "sourceType": {
                  "type": "string",
                  "enum": [
                    "web_search",
                    "company_website",
                    "news",
                    "government_registry",
                    "regulatory_registry",
                    "sanctions_list",
                    "domain_registry",
                    "rafid_oman_registry",
                    "not_configured"
                  ]
                },
                "observedAt": {
                  "type": "string"
                }
              },
              "required": [
                "url",
                "title",
                "publisher",
                "sourceType",
                "observedAt"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "name",
          "website",
          "industry",
          "location",
          "employeeRange",
          "description",
          "whyMatched",
          "sources"
        ],
        "additionalProperties": false
      }
    },
    "resultCount": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": "string"
          },
          "publisher": {
            "type": [
              "string",
              "null"
            ]
          },
          "sourceType": {
            "type": "string",
            "enum": [
              "web_search",
              "company_website",
              "news",
              "government_registry",
              "regulatory_registry",
              "sanctions_list",
              "domain_registry",
              "rafid_oman_registry",
              "not_configured"
            ]
          },
          "observedAt": {
            "type": "string"
          }
        },
        "required": [
          "url",
          "title",
          "publisher",
          "sourceType",
          "observedAt"
        ],
        "additionalProperties": false
      }
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "cached": {
      "type": "boolean"
    },
    "dataMode": {
      "type": "string",
      "enum": [
        "live",
        "not_configured"
      ]
    },
    "requestedLimit": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "appliedLimit": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "companies",
    "resultCount",
    "sources",
    "confidence",
    "cached",
    "dataMode",
    "requestedLimit",
    "appliedLimit",
    "limitations"
  ],
  "additionalProperties": false
}

Category: Company & Risk Intelligence · hierarchy: supporting · idempotent: yes · side effects: no