fetchserp 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aee8e95fe03152c7170f302c9dc12708b6dd34be523518d19d68d06806faf1f0
-  data.tar.gz: 9e5bf93d85115a71444f7d012d91e202565e050ba22126e008ddbca3cf17f8ea
+  metadata.gz: 91466f965fcbd70fc4997aae636b8aa4873adcc3729dd8dad0b5fa65572c1276
+  data.tar.gz: da63d872dbbb50aaf8c82b43eef6ec36c2c39eaace88ce2744b20be316ae5051
 SHA512:
-  metadata.gz: 7b5f79d83dab6a5ac4a608aa47c90b8571a1cc9d898faa41f02f062ead8efd6cd93aef3d91a48d529d131fab0beafe987be01004d204fb1c08f57b42219db75c
-  data.tar.gz: e36ebed82d26a5e684a7010ed5b1ddab57c9081c030466e9e60fadbfc5da040e6d8e4862d1e8b3b62ddbb92d52d34d6f5e5bbf99c33bc65bef7a115f28b729f2
+  metadata.gz: 7a9dc0945b450e9a090b883a98d608c6c7c3c95d44c6a62eef1fe1bedef0b11f9f112b4afbf6d613e52ceb8d61afb832fdd7ccd1b81d5455d6f6abc63e9c1947
+  data.tar.gz: 668d9e2193e5a32d859b07731d9eccaa52de28e53fefe10065c648c974a0dd0063ddabd448362a9ee3494944922f2291966c39e4e1da423d736127c4b91ff915

data/README.md

@@ -59,6 +59,8 @@ 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`
@@ -88,6 +90,8 @@ 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` |
@@ -136,6 +140,39 @@ resp = client.playwright_mcp(prompt: "Navigate to google.com and search for 'rub
 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:
@@ -154,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

data/lib/fetchserp/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fetchserp
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - FetchSERP
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-14 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.