Redesign API directory experience

CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing to the CoreClaw API Directory
+
+Thanks for helping keep the directory accurate, useful and easy to browse.
+
+## Quick rules
+
+- Match Workers by their stable `owner/name` path, not by title.
+- Keep titles and descriptions faithful to the public CoreClaw Store.
+- Use one concise description focused on the data returned by the Worker.
+- Preserve `?fpr=chris69` on public Worker URLs.
+- Keep the affiliate disclosure visible in the README.
+- Do not add private, unlisted or inaccessible Workers.
+
+## Adding or updating a Worker
+
+Every CSV record must include:
+
+| Field | Requirement |
+|---|---|
+| `title` | Public Worker title |
+| `path` | Stable `owner/name` path |
+| `url` | Direct Worker URL ending in `?fpr=chris69` |
+| `category` | One of the directory categories below |
+| `source` | Human-friendly website or data source |
+| `platform` | Platform label returned by CoreClaw |
+| `author` | Worker publisher |
+| `description` | One clear sentence describing the output |
+
+## Categories
+
+- E-Commerce & Marketplaces
+- Social & Creator Data
+- Search, Maps & SEO
+- Jobs & Recruiting
+- Lead Generation & Company Intelligence
+- AI & Research
+- Developer & Web Utilities
+- Finance & Markets
+- Real Estate
+- Education & Knowledge
+- News & Media
+
+Choose the category that best describes the Worker’s primary use case. Use `source` for the website or service being queried.
+
+## Validation
+
+From the repository root:
+
+```bash
+python scripts/validate_catalog.py
+```
+
+The validator checks required CSV fields, unique Worker paths, affiliate URLs, README coverage and the SVG banner.
+
+## Pull-request checklist
+
+- [ ] The Worker is publicly accessible.
+- [ ] The path is unique.
+- [ ] The direct URL contains `?fpr=chris69`.
+- [ ] The README and CSV are both updated.
+- [ ] The category and source are accurate.
+- [ ] `python scripts/validate_catalog.py` passes.