# Rafid Book — Competitor Analysis Chapter

> Rafid Book — Competitor Analysis Chapter is a paid API for AI agents from api.rafidsystem.com, paid per call via x402, $0.3/call, status unknown (last checked 2026-10-10).

Generates a structured competitor analysis section (chapter) for a small business planning book, using supplied competitor profiles including strengths, weaknesses, pricing, and positioning.

## Facts

- Endpoint: POST https://api.rafidsystem.com/api/v1/x402/book/competitor-analysis?utm_source=zero.xyz
- Price: $0.3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rafid-book-competitor-analysis-chapter-1c010c87
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xE3Ekk_Ut99hPVnyJJdgZ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability rafid-book-competitor-analysis-chapter-1c010c87 -d '<json body>'
```

Example prompt: Write the competitor analysis chapter for my small business book in English — I have 3 competitors: Al Masa Café (coffee and pastries, 2.5 OMR average, strengths: central location and loyal customers, weaknesses: no online ordering, complaints: slow service), Brew & Co (specialty coffee, 3.0 OMR, strengths: trendy branding, weaknesses: high price, positioning: premium urban), and Qahwa House (traditional coffee, 1.8 OMR, strengths: authenticity and low price, weaknesses: limited menu, positioning: heritage).

## When to prefer this

Choose this endpoint when you need a book-chapter-style, framework-grounded competitor analysis output (not a raw data dump), particularly for small business planning contexts in Oman or Arabic-language markets. It is ideal when the agent has already gathered structured competitor data (names, prices in OMR, strengths, weaknesses) and needs to produce a coherent, publication-ready narrative section. Prefer this over generic LLM analysis when you want output anchored to a recognized Omani entrepreneurship framework (Creative Techno, 2026 edition).

## Known failure modes

- Fewer than 3 competitors supplied — minimum 3 required, returns validation error
- Competitor name exceeds 200 characters or is empty — schema validation failure
- More than 20 competitors supplied — exceeds maxItems limit
- priceOMR value out of range (negative or above 1,000,000) — validation error
- Invalid language code (not 'ar' or 'en') — enum validation failure
- Individual strength/weakness/complaint items exceed 500 characters — validation error
- Payment not completed (x402 protocol) — 402 Payment Required response
- Malformed JSON body — 400 Bad Request

## How this service works

Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.

## Output

Returns a JSON object containing a structured competitor analysis chapter sourced from the Rafid book framework (e.g. 'كيف تبدأ مشروعك الصغير في عُمان؟' 2026 edition), with the result keyed under 'result.sourceChapter' (value: 'book'), the response language, and framework source metadata including title, edition, and publisher. The chapter content provides a narrative competitive landscape analysis shaped by the supplied competitor profiles.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "language": {
   "enum": [
    "ar",
    "en"
   ],
   "type": "string",
   "default": "en"
  },
  "competitors": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
     },
     "product": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1
     },
     "priceOMR": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0,
      "description": "OMR; calculations use integer baisa internally"
     },
     "strengths": {
      "type": "array",
      "items": {
       "type": "string",
       "maxLength": 500,
       "minLength": 1
      },
      "maxItems": 100
     },
     "complaints": {
      "type": "array",
      "items": {
       "type": "string",
       "maxLength": 500,
       "minLength": 1
      },
      "maxItems": 100
     },
     "weaknesses": {
      "type": "array",
      "items": {
       "type": "string",
       "maxLength": 500,
       "minLength": 1
      },
      "maxItems": 100
     },
     "positioning": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 20,
   "minItems": 3
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "sourceChapter": "book"
  },
  "language": "en",
  "frameworkSource": {
   "title": "كيف تبدأ مشروعك الصغير في عُمان؟",
   "edition": "2026",
   "publisher": "Creative Techno"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rafid-book-competitor-analysis-chapter-1c010c87/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.rafidsystem.com](https://www.zero.xyz/host/api.rafidsystem.com/llms.txt)