[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_118":119},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":57,"_58":-5,"_59":51,"_60":45,"_61":62,"_63":-5,"_64":-5,"_65":11,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":-5,"_79":-5,"_80":-5,"_81":82,"_83":-5,"_84":45,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96},"apiUrl","https://odel.app/api","creator","theservicemarketingguys","moduleId","audit","@theservicemarketingguys/audit","displayName","The Service Marketing Guys Audit","tagline","Read-only audit of any local service business, Open Service Profile conformance first.","iconKey","https://avatars.githubusercontent.com/u/301312463?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://www.theservicemarketingguys.com/api/audit-mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","priceCredits",0,"creatorUserId","system:external-import","createdAt",1789101245000,"updatedAt",1790463275000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=com.theservicemarketingguys%2Faudit","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars","upstreamUpdatedAt",1789067781000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt",1790447629000,"githubRepoUrl","https://github.com/buildmodus/open-service-profile","githubRepoFullName","buildmodus/open-service-profile","releaseId","ext-buildmodus-open-service-profile","version","0.1.0","descriptionMarkdown","# Open Service Profile\n\nOpen Service Profile (OSP) is a machine-readable description of a local service business, published at `/.well-known/open-service-profile`, that tells AI agents what the business does, where it works, when it is open, and how to request a booking.\n\nIt covers dispatch-based and shop-based trades: HVAC, plumbing, electrical, landscaping, auto repair, marine repair, and similar. The manifest carries identity, locations and hours, services, ZIP coverage, and a booking policy. Six tools over the Model Context Protocol let an agent read the profile, check coverage, check availability, and submit a booking request. A booking request is a request, never a confirmation; the specification fixes that semantic so an agent cannot tell a customer an appointment exists when it does not.\n\n## Status\n\nDraft v0.1, published 2026-09-07 and revised 2026-09-09 (0.1.0-draft.4, a text-only revision). The draft is stable enough to implement. Changes before 1.0 arrive as versioned releases with a changelog; see [CONTRIBUTING.md](https://github.com/buildmodus/open-service-profile/blob/main/CONTRIBUTING.md) for how changes are decided.\n\n## Specification\n\n- Canonical, versioned: https://www.theservicemarketingguys.com/standards/open-service-profile/v0.1\n- Landing page (latest version): https://www.theservicemarketingguys.com/standards/open-service-profile/\n\nThe Markdown in [`spec/`](https://github.com/buildmodus/open-service-profile/blob/main/spec/) is the source text. The website is the canonical rendering, and citations should use the versioned URL above.\n\n## Maintainer\n\nThe Service Marketing Guys, an EasyServe company. Issues and pull requests are welcome here.\n\n## What is in this repository\n\n```\nspec/\n v0.1.md specification source text\nschemas/v0.1/\n manifest.schema.json Appendix A, the manifest document\n tools/\n tools-common.schema.json shared definitions for tool schemas\n .input.schema.json one per tool, Appendix B\n .output.schema.json one per tool, Appendix B\nexamples/v0.1/\n hvac-two-locations.json Appendix C.1\n auto-repair-single-location.json Appendix C.2\n marine-repair-yard.json Appendix C.3\n hvac-two-locations.level1.jsonld Appendix C.4, Level 1 JSON-LD for the C.1 business\nscripts/\n validate-examples.mjs validates the examples against the manifest schema and the Appendix A constraints\n extract-from-spec.mjs regenerates schemas/ and examples/ from spec/v0.1.md\nbin/\n open-service-profile.mjs the generator CLI (npx open-service-profile init )\nsrc/\n validate.mjs the examples script's and the CLI's validator, a thin call into the generated core\n crawl.mjs the CLI's bounded site crawl: pinned connections, private-address policy, host fence\n places.mjs optional Google listing lookup (your own key)\n core/ GENERATED generator core; source of truth is the maintainer's TypeScript\ntests/\n cli.test.mjs node --test; fixture sites under tests/fixtures/\n```\n\nEvery tool output schema is `oneOf` a success shape and an error shape. The error shape is `tools-common.schema.json#/$defs/ErrorResult`, constrained in each tool's schema to that tool's error codes.\n\nRun `npm run validate` to check the examples. There are no dependencies.\n\n## Generate your profile\n\nThe repository also ships a small command-line tool that drafts a business's Open Service Profile from its own website. It also writes the business's `llms.txt`. Node 20 or newer, no dependencies.\n\n```\nnpx open-service-profile init example.com\n```\n\nIt reads up to twelve pages (home, contact, schedule, about, then service and location pages from the sitemap) and writes five files into `./open-service-profile/`:\n\n| file | host it at |\n|---|---|\n| `open-service-profile.json` | `/.well-known/open-service-profile`, served as `application/json` with `Access-Control-Allow-Origin: *` |\n| `llms.txt` | `/llms.txt` |\n| `llms-full.txt` | `/llms-full.txt` (every fact with the page it was read from, and how each derived value was produced) |\n| `robots-ai-section.txt` | merge into `/robots.txt` (a commented template until you answer the two crawler questions) |\n| `jsonld.html` | paste inside `` on the home page (the Level 1 JSON-LD: a LocalBusiness node with a ScheduleAction) |\n\nOne rule governs every line: a fact the pages do not state becomes a `# TODO:` line, never a plausible default. No price, hour, service, or certification is invented; a service is listed only from a page that was actually read; ratings or review counts found in the page markup are never copied (the standard forbids them). The draft claims Level 1 only when every Level 1 fact is established, no value is an inference from wording, the manifest validates against Appendix A, and the home page already carries the Level 1 JSON-LD; it never claims Level 2, because the tool builds no MCP server.\n\nSome things no website states, so the tool asks rather than guess: the booking policy (earliest day you accept requests for, weekend requests, emergency or after-hours availability, how you confirm), the two `robots.txt` choices (may AI assistants read your pages; may they be used for training), and, only when the pages do not settle them, the service model (one recognized trade settles it), the primary location (one location is primary by definition), and the time zone (a state in one zone settles it). Pass them as flags, or run in a terminal and answer the questions; unanswered fields stay TODO lines. The three standard windows are written by id only, with no clock times.\n\n```\nnpx open-service-profile init example.com --min-days-ahead 1 --weekend-requests saturday_only --emergency no --contact-methods call,email --ai-read yes --ai-train no\n```\n\nOptions:\n\n- `--min-days-ahead ` (0 to 60), `--weekend-requests `, `--emergency `, `--contact-methods `: the booking policy, in your own words.\n- `--ai-read `, `--ai-train `: the `robots.txt` choices. Without them the section is a commented template that changes nothing.\n- `--service-model `, `--primary `, `--time-zone `: asked only when the pages do not settle them.\n- `--place-id ` also reads the business's Google Business Profile listing through the Places API, using your own `GOOGLE_PLACES_API_KEY`. Listing facts fill only what the site lacks and never override it, and the listing is used only once it is confirmed as this business (its website is the crawled site, or, when it lists none, its phone or its name and postal code match the site).\n- `--out ` chooses where the files go. `--json` prints the whole result (manifest, files, TODO list, facts with sources) to stdout instead.\n- `--verbose` prints each URL as it is fetched.\n\nThe crawl refuses private, loopback, link-local, unique-local, multicast, and cloud-metadata addresses, in IPv4 and in every IPv6 form that embeds an IPv4 address (mapped, compatible, NAT64). Each hostname is resolved once, judged, and the connection is pinned to the judged addresses; redirects and sitemap children may name only the same host or its www twin. There is no switch that loosens this.\n\nThe same generator runs as a web tool on the parent site: https://www.theservicemarketingguys.com/tools/open-service-profile\n\nThe generator's core (`src/core/`) is generated from the maintainer's TypeScript and carries a header saying so; edit it there, not here. The manifest validator is part of that core, so the web tool, the public audit, this CLI, and `npm run validate` judge a manifest by one implementation. `src/crawl.mjs`, `src/places.mjs`, `src/validate.mjs`, and `bin/` are this repository's own. Run `npm test` for the CLI tests (Node's built-in runner, fixture sites served locally over a pinned connection).\n\n## Skills\n\n[`skills/`](https://github.com/buildmodus/open-service-profile/blob/main/skills/) holds two Agent Skills: `open-service-profile` for an agent acting on a customer's behalf (discover the manifest, read it, call the tools, send a booking request under the consent rule) and `open-service-profile-publish` for a developer or site owner publishing a profile. Install with `npx skills add buildmodus/open-service-profile`. See [skills/README.md](https://github.com/buildmodus/open-service-profile/blob/main/skills/README.md).\n\n## Implementations\n\nThe Service Marketing Guys serves Level 2 manifests on its client sites, built from the same data that drives each site. Example: https://coastalecoheatair.com/.well-known/open-service-profile\n\nAppendix D of the specification lists where the reference implementation and the specification still differ.\n\n## How to propose changes\n\nOpen an issue or a pull request. [CONTRIBUTING.md](https://github.com/buildmodus/open-service-profile/blob/main/CONTRIBUTING.md) describes what a proposal should include and how decisions and releases are made. Reports of places where the specification and a real implementation disagree are especially welcome.\n\n## Citation\n\nCite the versioned specification, not this repository. [CITATION.cff](https://github.com/buildmodus/open-service-profile/blob/main/CITATION.cff) carries the preferred citation, and GitHub's \"Cite this repository\" button reads it.\n\n## Licensing\n\nTwo licenses apply, by artifact:\n\n- Specification text (`spec/`): Creative Commons Attribution 4.0 International. See [LICENSE-SPEC.md](https://github.com/buildmodus/open-service-profile/blob/main/LICENSE-SPEC.md).\n- JSON Schemas, examples, scripts, and the generator (`schemas/`, `examples/`, `scripts/`, `src/`, `bin/`, `tests/`): MIT. See [LICENSE](https://github.com/buildmodus/open-service-profile/blob/main/LICENSE).\n\nCopyright 2026 EasyServe LLC.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt",1789070406000,"priceCents","trialDays","iconType","image","upstream",{"_105":106,"_107":108,"_109":110,"_111":112,"_113":114,"_115":116},"requiredSecrets",[],"tags",[99,100,101,102,103,104],"assets",[],"stats",{"_97":45,"_98":45},"ratingAvg","reviewCount","ai-agents","booking","field-service","json-schema","local-business","open-standard","topics",[99,100,101,102,103,117,104],"license","MIT","language","JavaScript","registryName","com.theservicemarketingguys/audit","homepage","https://www.theservicemarketingguys.com/standards/open-service-profile/v0.1","packages",[],"mcp","ENV",{"_120":121,"_122":123,"_124":125,"_126":-7},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272","SENTRY_ENABLE_LOCAL"]