Skip to content

README: lead with what the SDK does - #38

Merged
YahiaBakour merged 3 commits into
mainfrom
docs/context-dev-readme-opening
Oct 8, 2026
Merged

YahiaBakour merged 3 commits into
mainfrom
docs/context-dev-readme-opening

Conversation

@YahiaBakour

@YahiaBakour YahiaBakour commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Leads with a scrape request that returns markdown and HTML, followed by runnable examples for structured JSON, relevant highlights, and screenshots. Replaces every brand-lookup code sample throughout the README with scraping, including applicable async, error handling, retry, timeout, typing, and raw-response examples.

Also adds the capability table and agent integration links, and removes the Stainless attribution. Only README.md changes; source code, package names, versions, and generated API references are untouched.

Titles remain configured centrally in https://github.com/context-dot-dev/brand-dev-server/pull/1669. That companion PR now also configures scraping for both default and headline examples. The README examples are updated directly so these PRs show the complete scraping documentation immediately.

Validation: All 7 scraping snippets pass php -l. Named arguments, format flags, highlights parameters, and output data fields match the SDK service and models. git diff --check passes. No live API requests were made.

Sources checked:

  • src/Services/WebService.php
  • src/Web/WebScrapeParams/JsonParams.php
  • src/Web/WebScrapeResponse.php
  • src/Web/WebScrapeResponse/Markdown.php
  • src/Web/WebScrapeResponse/Json.php
  • src/Services/ParseService.php
  • src/Services/BatchService.php
  • src/Services/MonitorsService.php
  • src/Services/BrandService.php
  • src/Web/WebScrapeParams/Formats.php
  • src/Web/WebScrapeParams/HighlightsParams.php
  • src/Web/WebScrapeResponse/Highlights.php
  • src/Web/WebScrapeResponse/Screenshot.php

This repository has no api.md; method names were verified in its resource/service definitions.

@YahiaBakour
YahiaBakour merged commit e19c5cc into main Oct 8, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant