research_company

Research a company from public web sources: overview, products, leadership, funding, competitors, technology signals, recent developments and risk flags, with cited sources and a confidence score.

When to use

Use when an agent needs a structured research brief on a named company — for sales/investment/partnership research, competitive analysis, or general company background — beyond what a structured company registry alone provides.

Selection guidance

Role: supporting. Use when an agent needs a structured research brief on a named company — for sales/investment/partnership research, competitive analysis, or general company background — beyond what a structured company registry alone provides.

Use cases

• company background research
• sales prospect research
• investment/competitor research
• build a company profile from public web sources

Access

• REST: POST https://api.rafidsystem.com/api/v1/intelligence/research-company
• x402: POST https://api.rafidsystem.com/api/v1/x402/intelligence/research-company
• MCP tool: research_company
• Free preview: POST https://api.rafidsystem.com/api/v1/preview/research_company

Price: $0.15 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
• company_risk_batch
• company_risk_report
• due_diligence_oman_company
• analyze_company_risk

Example input

{
  "company": "Acme Corporation",
  "website": "https://acme.example.com",
  "country": "United States",
  "depth": "standard"
}

Example output

{
  "company": {
    "name": "Acme Corporation",
    "website": "https://acme.example.com",
    "industry": null,
    "headquarters": null,
    "founded": null
  },
  "overview": null,
  "productsAndServices": [],
  "leadership": [],
  "funding": {
    "summary": null,
    "knownRounds": []
  },
  "competitors": [],
  "technologySignals": [],
  "recentDevelopments": [],
  "riskFlags": [],
  "sources": [],
  "confidence": 0,
  "dataFreshness": {
    "latestSourceDate": null,
    "freshnessDays": null
  },
  "cached": false,
  "dataMode": "not_configured",
  "limitations": [
    "No web search provider is configured for this deployment (WEB_SEARCH_PROVIDER is not set) — no external research was performed.",
    "This result is derived from public web search results, not verified company records or a direct company disclosure.",
    "Coverage depends on what is publicly indexed and searchable — a real, established company with limited public web presence will correctly return sparse results, not a false negative about its existence."
  ]
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "website": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    },
    "country": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "depth": {
      "default": "standard",
      "type": "string",
      "enum": [
        "quick",
        "standard",
        "deep"
      ]
    },
    "focusAreas": {
      "maxItems": 9,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "overview",
          "products",
          "leadership",
          "funding",
          "competitors",
          "technology",
          "recent_news",
          "market_position",
          "risks"
        ]
      }
    }
  },
  "required": [
    "company",
    "depth"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "company": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "website": {
          "type": [
            "string",
            "null"
          ]
        },
        "industry": {
          "type": [
            "string",
            "null"
          ]
        },
        "headquarters": {
          "type": [
            "string",
            "null"
          ]
        },
        "founded": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "name",
        "website",
        "industry",
        "headquarters",
        "founded"
      ],
      "additionalProperties": false
    },
    "overview": {
      "type": [
        "string",
        "null"
      ]
    },
    "productsAndServices": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "leadership": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "name",
          "title"
        ],
        "additionalProperties": false
      }
    },
    "funding": {
      "type": "object",
      "properties": {
        "summary": {
          "type": [
            "string",
            "null"
          ]
        },
        "knownRounds": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "round": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "amount": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "investors": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "round",
              "amount",
              "date",
              "investors"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "summary",
        "knownRounds"
      ],
      "additionalProperties": false
    },
    "competitors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "reason"
        ],
        "additionalProperties": false
      }
    },
    "technologySignals": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "recentDevelopments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "date": {
            "type": [
              "string",
              "null"
            ]
          },
          "summary": {
            "type": "string"
          },
          "source": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "title",
          "date",
          "summary",
          "source"
        ],
        "additionalProperties": false
      }
    },
    "riskFlags": {
      "type": "array",
      "items": {
        "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
      }
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "dataFreshness": {
      "type": "object",
      "properties": {
        "latestSourceDate": {
          "type": [
            "string",
            "null"
          ]
        },
        "freshnessDays": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "latestSourceDate",
        "freshnessDays"
      ],
      "additionalProperties": false
    },
    "cached": {
      "type": "boolean"
    },
    "dataMode": {
      "type": "string",
      "enum": [
        "live",
        "not_configured"
      ]
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "company",
    "overview",
    "productsAndServices",
    "leadership",
    "funding",
    "competitors",
    "technologySignals",
    "recentDevelopments",
    "riskFlags",
    "sources",
    "confidence",
    "dataFreshness",
    "cached",
    "dataMode",
    "limitations"
  ],
  "additionalProperties": false
}

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