{
  "openapi": "3.1.0",
  "info": {
    "title": "Fieldwright API",
    "version": "1.0.0",
    "summary": "Free API and MCP server: URL in; compact Markdown, title, description, language, canonical, OpenGraph, JSON-LD, emails and phones out. No LLM key needed.",
    "description": "Give a URL, get the page as compact Markdown (links and tables kept) plus its title, description, language, canonical URL, OpenGraph tags, JSON-LD structured data, emails and phone numbers. No AI key needed.\n\nFree tier: 20 calls per minute per IP address. One URL per call. Markdown up to 20,000 characters (default 8,000); pages up to 1 MB. About 15 seconds per call at most. No JavaScript rendering. Free, no key. No AI model runs here and no keys are accepted. No key needed. Remote MCP server: https://fieldwright.cybermax-tools.workers.dev/mcp",
    "contact": {
      "name": "CyberMax",
      "url": "https://cybermax-tools-cybermax.static.hf.space/"
    },
    "license": {
      "name": "Proprietary (free to call)",
      "identifier": "LicenseRef-CyberMax"
    }
  },
  "servers": [
    {
      "url": "https://fieldwright.cybermax-tools.workers.dev"
    }
  ],
  "paths": {
    "/api/extract": {
      "get": {
        "tags": [
          "Fieldwright"
        ],
        "summary": "One URL to Markdown + metadata (no-key mode)",
        "description": "Fetches the page (charset-aware, up to 1 MB, no JavaScript rendering) and returns title, description, language, canonical URL, OpenGraph/Twitter tags, JSON-LD blocks, mailto emails, tel phones and compact Markdown (the main/article element when the page is long).",
        "operationId": "extractPageGet",
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "Page URL",
            "schema": {
              "type": "string"
            },
            "example": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html"
          },
          {
            "name": "maxChars",
            "in": "query",
            "required": false,
            "description": "Markdown length cap (500-20000, default 8000)",
            "schema": {
              "type": "integer",
              "minimum": 500,
              "maximum": 20000,
              "default": 8000
            }
          },
          {
            "name": "markdown",
            "in": "query",
            "required": false,
            "description": "Include the Markdown (default true)",
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "example": {
                  "results": [
                    {
                      "url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
                      "finalUrl": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
                      "title": "A Light in the Attic | Books to Scrape - Sandbox",
                      "pageChars": 1877,
                      "truncated": false,
                      "httpStatus": 200,
                      "fetchedVia": "direct",
                      "ok": true,
                      "mode": "no-llm",
                      "description": "It's hard to imagine a world without A Light in the Attic. This now-classic collection of poetry and drawings from Shel Silverstein celebrates its 20th anniversary with this special edition. Silverstein's humorous and creative verse can amuse the dowdiest of readers. Lemon-faced adults and fidgety kids sit still and read these rhythmic words and laugh and smile and love th It's hard to imagine a world without A Light in the Attic. This now-classic collection of poetry and drawings from Shel Silverstein celebrates its 20th anniversary with this special edition. Silverstein's humorous and creative verse can amuse the dowdiest of readers. Lemon-faced adults and fidgety kids sit still and read these rhythmic words and laugh and smile and love that Silverstein. Need proof of his genius? RockabyeRockabye baby, in the treetopDon't you know a treetopIs no safe place to rock?And who put you up there,And your cradle, too?Baby, I think someone down here'sGot it in for you. Shel, you never sounded so good. ...more",
                      "language": "en-us",
                      "canonicalUrl": null,
                      "openGraph": {},
                      "jsonLd": [],
                      "emails": [],
                      "phones": [],
                      "markdown": "[Books to Scrape](https://books.toscrape.com/index.html) We love being scraped!\n\n- [Home](https://books.toscrape.com/index.html)\n- [Books](https://books.toscrape.com/catalogue/category/books_1/index.html)\n- [Poetry](https://books.toscrape.com/catalogue/category/books/poetry_23/index.html)\n- A Light in the Attic\n\n![A Light in the Attic](https://books.toscrape.com/media/cache/fe/72/fe72f0532301ec28892ae79a629a293c.jpg)\n\n# A Light in the Attic\n\n£51.77\n\nIn stock (22 available)\n\nWarning! This is a demo website for web scraping purposes. Prices and ratings here were randomly assigned and have no real meaning.\n\n## Product Description\n\nIt's hard to imagine a world without A Light in the Attic. This now-classic collection of poetry and drawings from Shel Silverstein celebrates its 20th anniversary with this special edition. Silverstein's humorous and creative verse can amuse the dowdiest of readers. Lemon-faced adults and fidgety kids sit still and read these rhythmic words and laugh and smile and love th It's hard to imagine a world without A Light in the Attic. This now-classic collection of poetry and drawings from Shel Silverstein celebrates its 20th anniversary with this special edition. Silverstein's humorous and creative verse can amuse the dowdiest of readers. Lemon-faced adults and fidgety kids sit still and read these rhythmic words and laugh and smile and love that Silverstein. Need proof of his genius? RockabyeRockabye baby, in the treetopDon't you know a treetopIs no safe place to rock?And who put you up there,And your cradle, too?Baby, I think someone down here'sGot it in for you. Shel, you never sounded so good. ...more\n\n## Product Information\n\n| UPC | a897fe39b1053632 |\n| Product Type | Books |\n| Price (excl. tax) | £51.77 |\n| Price (incl. tax) | £51.77 |\n| Tax | £0.00 |\n| Availability | In stock (22 available) |\n| Number of reviews | 0 |",
                      "ms": 176,
                      "extractedAt": "2026-09-25T23:03:28.294Z"
                    }
                  ],
                  "count": 1
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (see the Retry-After header)",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "504": {
            "description": "Took too long; ask for fewer items",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Fieldwright"
        ],
        "summary": "One URL to Markdown + metadata (no-key mode)",
        "description": "Fetches the page (charset-aware, up to 1 MB, no JavaScript rendering) and returns title, description, language, canonical URL, OpenGraph/Twitter tags, JSON-LD blocks, mailto emails, tel phones and compact Markdown (the main/article element when the page is long).",
        "operationId": "extractPagePost",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "format": "uri"
                  },
                  "maxChars": {
                    "type": "integer",
                    "minimum": 500,
                    "maximum": 20000
                  },
                  "markdown": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "url"
                ]
              },
              "example": {
                "url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
                "maxChars": 4000
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "example": {
                  "results": [
                    {
                      "url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
                      "finalUrl": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
                      "title": "A Light in the Attic | Books to Scrape - Sandbox",
                      "pageChars": 1877,
                      "truncated": false,
                      "httpStatus": 200,
                      "fetchedVia": "direct",
                      "ok": true,
                      "mode": "no-llm",
                      "description": "It's hard to imagine a world without A Light in the Attic. This now-classic collection of poetry and drawings from Shel Silverstein celebrates its 20th anniversary with this special edition. Silverstein's humorous and creative verse can amuse the dowdiest of readers. Lemon-faced adults and fidgety kids sit still and read these rhythmic words and laugh and smile and love th It's hard to imagine a world without A Light in the Attic. This now-classic collection of poetry and drawings from Shel Silverstein celebrates its 20th anniversary with this special edition. Silverstein's humorous and creative verse can amuse the dowdiest of readers. Lemon-faced adults and fidgety kids sit still and read these rhythmic words and laugh and smile and love that Silverstein. Need proof of his genius? RockabyeRockabye baby, in the treetopDon't you know a treetopIs no safe place to rock?And who put you up there,And your cradle, too?Baby, I think someone down here'sGot it in for you. Shel, you never sounded so good. ...more",
                      "language": "en-us",
                      "canonicalUrl": null,
                      "openGraph": {},
                      "jsonLd": [],
                      "emails": [],
                      "phones": [],
                      "markdown": "[Books to Scrape](https://books.toscrape.com/index.html) We love being scraped!\n\n- [Home](https://books.toscrape.com/index.html)\n- [Books](https://books.toscrape.com/catalogue/category/books_1/index.html)\n- [Poetry](https://books.toscrape.com/catalogue/category/books/poetry_23/index.html)\n- A Light in the Attic\n\n![A Light in the Attic](https://books.toscrape.com/media/cache/fe/72/fe72f0532301ec28892ae79a629a293c.jpg)\n\n# A Light in the Attic\n\n£51.77\n\nIn stock (22 available)\n\nWarning! This is a demo website for web scraping purposes. Prices and ratings here were randomly assigned and have no real meaning.\n\n## Product Description\n\nIt's hard to imagine a world without A Light in the Attic. This now-classic collection of poetry and drawings from Shel Silverstein celebrates its 20th anniversary with this special edition. Silverstein's humorous and creative verse can amuse the dowdiest of readers. Lemon-faced adults and fidgety kids sit still and read these rhythmic words and laugh and smile and love th It's hard to imagine a world without A Light in the Attic. This now-classic collection of poetry and drawings from Shel Silverstein celebrates its 20th anniversary with this special edition. Silverstein's humorous and creative verse can amuse the dowdiest of readers. Lemon-faced adults and fidgety kids sit still and read these rhythmic words and laugh and smile and love that Silverstein. Need proof of his genius? RockabyeRockabye baby, in the treetopDon't you know a treetopIs no safe place to rock?And who put you up there,And your cradle, too?Baby, I think someone down here'sGot it in for you. Shel, you never sounded so good. ...more\n\n## Product Information\n\n| UPC | a897fe39b1053632 |\n| Product Type | Books |\n| Price (excl. tax) | £51.77 |\n| Price (incl. tax) | £51.77 |\n| Tax | £0.00 |\n| Availability | In stock (22 available) |\n| Number of reviews | 0 |",
                      "ms": 176,
                      "extractedAt": "2026-09-25T23:03:28.294Z"
                    }
                  ],
                  "count": 1
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (see the Retry-After header)",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "504": {
            "description": "Took too long; ask for fewer items",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "retryAfterSeconds": {
            "type": "integer"
          },
          "limits": {
            "type": "object"
          }
        },
        "required": [
          "error",
          "message"
        ]
      }
    }
  },
  "x-mcp-server": "https://fieldwright.cybermax-tools.workers.dev/mcp"
}