fetchserp 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0074340ccc01f75f24314a4793bf0949e440e18673393957dc51a52c740eb17d
-  data.tar.gz: 9c32a55e21868b613bfb952ee4ae8dbe8c769b15ba80f50cad9947e1a3465840
+  metadata.gz: 91466f965fcbd70fc4997aae636b8aa4873adcc3729dd8dad0b5fa65572c1276
+  data.tar.gz: da63d872dbbb50aaf8c82b43eef6ec36c2c39eaace88ce2744b20be316ae5051
 SHA512:
-  metadata.gz: '0159792db3d0f8ece50c0c50d42e09a550a7b1e6bcb672b8874bb10187b38e481572626d6938275e8f7becb0060a70f95974836a26f86c3efbfb65e816e9f0bd'
-  data.tar.gz: 3b30f3fcc8b587214626a603b335d1b84ddba0efe2884ad22aa157bc03a9c3ab0a2c50d4c026bb4c1ff4ed84cd01ed39ee5885a6d461468897d3d0c6d0f7850d
+  metadata.gz: 7a9dc0945b450e9a090b883a98d608c6c7c3c95d44c6a62eef1fe1bedef0b11f9f112b4afbf6d613e52ceb8d61afb832fdd7ccd1b81d5455d6f6abc63e9c1947
+  data.tar.gz: 668d9e2193e5a32d859b07731d9eccaa52de28e53fefe10065c648c974a0dd0063ddabd448362a9ee3494944922f2291966c39e4e1da423d736127c4b91ff915

data/README.md

@@ -59,16 +59,20 @@ The client will raise `FetchSERP::Error` on any HTTP error (network, 4xx, 5xx) s
 * `/api/v1/backlinks`
 * `/api/v1/domain_emails`
 * `/api/v1/domain_infos`
+* `/api/v1/generate_social_content`
+* `/api/v1/generate_wordpress_content`
 * `/api/v1/keywords_search_volume`
 * `/api/v1/keywords_suggestions`
 * `/api/v1/long_tail_keywords_generator`
 * `/api/v1/page_indexation`
+* `/api/v1/playwright_mcp`
 * `/api/v1/ranking`
 * `/api/v1/scrape`
 * `/api/v1/scrape_domain`
 * `/api/v1/scrape_js`
 * `/api/v1/scrape_js_with_proxy`
 * `/api/v1/serp`
+* `/api/v1/serp_ai_mode`
 * `/api/v1/serp_html`
 * `/api/v1/serp_js` & `/api/v1/serp_js/{uuid}`
 * `/api/v1/serp_text`
@@ -86,16 +90,20 @@ Below is the full list of convenience helpers exposed by `FetchSERP::Client`. Al
 | `backlinks(domain:, **opts)` | `GET /api/v1/backlinks` | `domain` |
 | `domain_emails(domain:, **opts)` | `GET /api/v1/domain_emails` | `domain` |
 | `domain_infos(domain:)` | `GET /api/v1/domain_infos` | `domain` |
+| `generate_social_content(user_prompt:, system_prompt:, **opts)` | `GET /api/v1/generate_social_content` | `user_prompt`, `system_prompt` |
+| `generate_wordpress_content(user_prompt:, system_prompt:, **opts)` | `GET /api/v1/generate_wordpress_content` | `user_prompt`, `system_prompt` |
 | `keywords_search_volume(keywords:, **opts)` | `GET /api/v1/keywords_search_volume` | `keywords` (Array) |
 | `keywords_suggestions(url: nil, keywords: nil, **opts)` | `GET /api/v1/keywords_suggestions` | one of `url` or `keywords` |
 | `long_tail_keywords_generator(keyword:, **opts)` | `GET /api/v1/long_tail_keywords_generator` | `keyword` |
 | `page_indexation(domain:, keyword:)` | `GET /api/v1/page_indexation` | `domain`, `keyword` |
+| `playwright_mcp(prompt:, **opts)` | `GET /api/v1/playwright_mcp` | `prompt` |
 | `ranking(keyword:, domain:, **opts)` | `GET /api/v1/ranking` | `keyword`, `domain` |
 | `scrape(url:)` | `GET /api/v1/scrape` | `url` |
 | `scrape_domain(domain:, **opts)` | `GET /api/v1/scrape_domain` | `domain` |
 | `scrape_js(url:, js_script: nil)` | `POST /api/v1/scrape_js` | `url` |
 | `scrape_js_with_proxy(url:, country:, js_script: nil)` | `POST /api/v1/scrape_js_with_proxy` | `url`, `country` |
 | `serp(query:, **opts)` | `GET /api/v1/serp` | `query` |
+| `serp_ai_mode(query:, **opts)` | `GET /api/v1/serp_ai_mode` | `query` |
 | `serp_html(query:, **opts)` | `GET /api/v1/serp_html` | `query` |
 | `serp_js(query:, **opts)` | `GET /api/v1/serp_js` | `query` |
 | `serp_js_content(uuid:)` | `GET /api/v1/serp_js/{uuid}` | `uuid` |
@@ -113,6 +121,58 @@ resp = client.keywords_suggestions(keywords: ["ruby sdk", "seo api"], country: "
 puts resp.data["keywords_suggestions"]
 ```
 
+### Example — Get SERP AI Overview and AI Mode
+
+```ruby
+client = FetchSERP.new(api_key: ENV["FETCHSERP_API_KEY"])
+
+# Get AI overview and AI mode response for a search query
+resp = client.serp_ai_mode(query: "ruby programming best practices")
+```
+
+### Example — Remote control browser with Playwright MCP
+
+```ruby
+client = FetchSERP.new(api_key: ENV["FETCHSERP_API_KEY"])
+
+# Use GPT-4.1 to remote control a browser via Playwright MCP
+resp = client.playwright_mcp(prompt: "Navigate to google.com and search for 'ruby gems'")
+puts resp.data["response"]
+```
+
+### Example — Generate WordPress Content with AI
+
+```ruby
+client = FetchSERP.new(api_key: ENV["FETCHSERP_API_KEY"])
+
+# Generate SEO-optimized WordPress content
+response = client.generate_wordpress_content(
+  user_prompt: "Write about the benefits of Ruby on Rails for web development",
+  system_prompt: "You are an expert web developer writing SEO content",
+  ai_model: "gpt-4.1-nano" # optional, defaults to gpt-4.1-nano
+)
+
+puts response.data["response"]["title"]    # Access the generated title
+puts response.data["response"]["content"]  # Access the generated content
+puts response.data["usd_cost"]            # Cost of the AI request in USD
+```
+
+### Example — Generate Social Media Content with AI
+
+```ruby
+client = FetchSERP.new(api_key: ENV["FETCHSERP_API_KEY"])
+
+# Generate engaging social media content
+response = client.generate_social_content(
+  user_prompt: "Write a Twitter thread about Ruby's best features",
+  system_prompt: "You are a Ruby developer sharing insights on social media",
+  ai_model: "gpt-4.1-nano" # optional, defaults to gpt-4.1-nano
+)
+
+puts response.data["response"]["content"]  # Access the generated social content
+puts response.data["usd_cost"]            # Cost of the AI request in USD
+```
+
 ### Handling errors
 
 Any 4xx/5xx response raises `FetchSERP::Error` which includes `status` and raw `body` so you can debug:
@@ -131,4 +191,10 @@ Bug reports and pull requests are welcome!
 
 ## License
 
-GPL-3.0 
+GPL-3.0 
+
+Publish :
+
+- update version
+- gem build fetchserp.gemspec
+- gem push fetchserp-0.1.3.gem

data/lib/fetchserp/client.rb

@@ -35,6 +35,16 @@ module FetchSERP
       get("/api/v1/domain_infos", params)
     end
 
+    # Generate WordPress content using AI - returns SEO optimized content with title and body
+    def generate_wordpress_content(**params)
+      get("/api/v1/generate_wordpress_content", params)
+    end
+
+    # Generate social media content using AI
+    def generate_social_content(**params)
+      get("/api/v1/generate_social_content", params)
+    end
+
     def keywords_search_volume(**params)
       get("/api/v1/keywords_search_volume", params)
     end
@@ -51,6 +61,11 @@ module FetchSERP
       get("/api/v1/page_indexation", params)
     end
 
+    # Playwright MCP - uses GPT-4.1 to remote control a browser via a Playwright MCP server
+    def playwright_mcp(**params)
+      get("/api/v1/playwright_mcp", params)
+    end
+
     def ranking(**params)
       get("/api/v1/ranking", params)
     end

data/lib/fetchserp/version.rb

@@ -1,3 +1,3 @@
 module FetchSERP
-  VERSION = "0.1.2"
+  VERSION = "0.1.4"
 end 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fetchserp
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - FetchSERP
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-25 00:00:00.000000000 Z
+date: 2025-07-21 00:00:00.000000000 Z
 dependencies: []
 description: A lightweight Ruby client for interacting with the FetchSERP API. Provides
   helpers for authentication and convenient Ruby methods for each endpoint.