feat: add files

Author: VinciGit00

README.md

@@ -176,6 +176,54 @@ $response = $client->request(
 );
 ```
 
+## Examples
+
+The `examples/` directory contains comprehensive examples demonstrating various use cases:
+
+### Basic Examples
+- **[SmartScraper](examples/basic/basic-smartscraper.php)** - Extract data from web pages using natural language prompts
+- **[Markdownify](examples/basic/basic-markdownify.php)** - Convert web pages to clean Markdown format
+- **[SearchScraper](examples/basic/basic-searchscraper.php)** - Search and scrape data from multiple websites
+- **[Crawl](examples/basic/basic-crawl.php)** - Systematically crawl entire websites
+- **[Generate Schema](examples/basic/basic-schema.php)** - Generate JSON schemas from natural language
+- **[Credits](examples/basic/basic-credits.php)** - Check your API credit balance
+- **[Validate](examples/basic/basic-validate.php)** - Validate your API key
+
+### Advanced Examples
+- **[Advanced SmartScraper](examples/advanced/advanced-smartscraper.php)** - Complex schemas, JavaScript rendering, pagination
+- **[Error Handling](examples/advanced/advanced-error-handling.php)** - Comprehensive error handling strategies
+
+### Real-World Use Cases
+- **[E-commerce Scraper](examples/use-cases/ecommerce-scraper.php)** - Product monitoring, price comparison, review analysis
+- **[News Aggregator](examples/use-cases/news-aggregator.php)** - Multi-source news monitoring, sentiment analysis
+- **[Job Listings](examples/use-cases/job-listings.php)** - Job search aggregation, salary benchmarking, skills analysis
+
+### Quick Start Example
+
+```php
+<?php
+require_once 'vendor/autoload.php';
+
+use Scrapegraphai\Client;
+use Scrapegraphai\Smartscraper\SmartscraperCreateParams;
+
+// Initialize client
+$client = new Client(
+    apiKey: getenv('SCRAPEGRAPHAI_API_KEY')
+);
+
+// Extract product information
+$params = SmartscraperCreateParams::from(
+    userPrompt: "Extract the product name, price, and rating",
+    websiteURL: "https://example-store.com/product"
+);
+
+$result = $client->smartscraper->create($params);
+echo json_encode($result->data, JSON_PRETTY_PRINT);
+```
+
+For more examples and detailed documentation, see the [examples directory](examples/).
+
 ## Versioning
 
 This package follows [SemVer](https://semver.org/spec/v2.0.0.html) conventions. As the library is in initial development and has a major version of `0`, APIs may change at any time.

examples/composer.json

@@ -0,0 +1,22 @@
+{
+    "name": "scrapegraphai/examples",
+    "description": "Examples for the ScrapeGraphAI PHP SDK",
+    "type": "project",
+    "require": {
+        "php": "^8.1",
+        "org-placeholder/scrapegraphai": "dev-main"
+    },
+    "autoload": {
+        "psr-4": {
+            "Examples\\": "src/"
+        }
+    },
+    "repositories": [
+        {
+            "type": "path",
+            "url": "../"
+        }
+    ],
+    "minimum-stability": "dev",
+    "prefer-stable": true
+}