misarseo 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 31f9863c4b7f4723163ddbca2c716dd97cc8b9ede908e30569397d492feb5453
+  data.tar.gz: f33667cb53a6b0b683d1c412714c1c124cf33c9c507be0635c3b3e9243002f9a
+SHA512:
+  metadata.gz: 6ccc2a49b94d5bb5fc479e7ff5d9f731af485c805dad52c54e53d2a92d8e0063521646be5e241643efef18946b1913976afc8e8d8289ae1c70d707bd6d40b23b
+  data.tar.gz: 5a77b689e14b3a3b214544cfd6cfa7539f6a028b444700358a4efbce44fd11dbcd6ea3485fe37a2d653d31058473e8add6859096226f8c47b3abe3657ffe1df7

data/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to this SDK are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] — 2026-10-16
+
+First release.
+
+### Added
+
+- The full MisarSEO API: 221 methods in 36 resource groups, generated from
+  `manifest.json` (itself generated from the API's OpenAPI route registry),
+  plus the crawl progress Server-Sent Events stream.
+- Bearer API-key authentication (`mseo_…`), with the key read from
+  `MISARSEO_API_KEY` where the platform has an environment.
+- A plan-limit error carrying the server's upgrade offer (`code:
+"plan_limit_exceeded"`; 402 for a locked feature or a point-in-time cap,
+  429 with `Retry-After` for a spent quota), detected by code and never
+  retried.
+- The shared retry policy: 429 for every method, 502/503/504 and network
+  failures for GET only, exponential backoff with jitter honouring
+  `Retry-After` up to 60 s.
+- Offset and cursor pagination helpers.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Misar.AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,257 @@
+# MisarSEO Ruby SDK
+
+> Keyword research, site audits, rank tracking and AI search visibility from Ruby.
+
+[![Gem](https://img.shields.io/gem/v/misarseo)](https://rubygems.org/gems/misarseo)
+[![license](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+
+**36 resource groups · 221 methods · SSE crawl streaming · standard library only**
+
+MisarSEO is one API for the SEO work around a site: keyword and competitor research, crawls and audits, rank tracking (organic, local and AI Overviews), backlinks, AI-search brand visibility, and the data Google Search Console, GA4, Bing, Yandex and Baidu hold about it. Ruby 2.6+. Every method returns the parsed JSON (Hash/Array).
+
+Package: `misarseo` on RubyGems. Source: [github.com/Misar-AI/misarseo-sdks](https://github.com/Misar-AI/misarseo-sdks/tree/main/ruby).
+
+---
+
+## Install
+
+### Bundler
+
+```ruby
+gem "misarseo"
+```
+
+### gem
+
+```bash
+gem install misarseo
+```
+
+---
+
+## Authentication
+
+Create an API key as described at https://seo.misar.io/ai. It starts with `mseo_` and is sent as `Authorization: Bearer mseo_…` — the only credential the SDK uses.
+
+Every call is decided server-side against the plan of the organization that owns the key; there is no client-side limit checking. A plan refusal carries `code: "plan_limit_exceeded"` and an upgrade offer, and is never retried (see [Plan limits](#plan-limits)).
+
+```ruby
+require "misarseo"
+
+seo = MisarSEO::Client.new(api_key: ENV["MISARSEO_API_KEY"])
+```
+
+---
+
+## Resources
+
+Every group the client exposes, and every method on it — generated from [`manifest.json`](./manifest.json), the same file every MisarSEO SDK is built from. Positional arguments: path parameters then required query parameters, then the JSON body (when the endpoint takes one); `query:` takes optional query parameters.
+
+### Workspace
+
+| Resource | Methods | What it covers |
+| --- | --- | --- |
+| `seo.projects` | `create`, `delete`, `get`, `list`, `update` | Projects in the organization: list, create, rename, archive. |
+| `seo.team` | `list_members` | Members, pending invitations and the caller's role (read-only). |
+| `seo.account` | `delete`, `delete_via_post`, `export` | Data-subject rights: full JSON export and account erasure. |
+| `seo.activity` | `list` | The organization's activity log, newest first (cursor paged). |
+| `seo.usage` | `get` | Plan tier, credits and quota usage for the organization. |
+| `seo.dashboard` | `get` | Cross-project overview — one card per active project. |
+| `seo.portfolios` | `add_projects`, `create`, `delete`, `get`, `list`, `remove_projects`, `rename` | Group projects and read their aggregate summary. |
+| `seo.report_builder` | `create_definition`, `delete_definition`, `delete_schedule`, `get_definition`, `get_schedule`, `list_definitions`, `rename_definition`, `render_definition`, `set_widgets`, `upsert_schedule` | User-composed report definitions, widgets, rendering and schedules. |
+
+### Keyword and competitive research
+
+| Resource | Methods | What it covers |
+| --- | --- | --- |
+| `seo.keywords` | `classify_intent`, `gap`, `list_saved`, `list_share_of_voice`, `potential`, `research`, `save`, `serp_overview`, `strategy`, `topic_research` | Keyword research, saved keywords, intent, SERP overview, gap, topic research, strategy, share of voice. |
+| `seo.domain` | `authority_history`, `batch_overview`, `capture_authority_snapshot`, `overview` | Domain overview, batch overview and authority history. |
+| `seo.backlinks` | `anchors`, `intersect`, `overview` | Backlink profile, anchors (offset paged) and link intersect. |
+| `seo.competitors` | `find` | SERP competitor discovery. |
+| `seo.content` | `optimizer`, `page_metrics` | On-page content optimizer and page metrics. |
+| `seo.mentions` | `media_monitoring`, `unlinked_mentions` | Unlinked brand mentions and media monitoring. |
+| `seo.competitor_monitor` | `add_target`, `list_changes`, `list_targets`, `remove_target` | Competitor page change detection. |
+| `seo.link_building` | `add`, `add_note`, `export_csv`, `import_csv`, `list`, `list_activity`, `remove`, `update`, `update_status` | Prospect list, outreach status, activity log, CSV import/export. |
+| `seo.disavow` | `add`, `export`, `list`, `remove` | Disavow entries and Google's disavow-file export. |
+
+### Site audit
+
+| Resource | Methods | What it covers |
+| --- | --- | --- |
+| `seo.crawl` | `clear_issue_status`, `comparison`, `core_web_vitals`, `create_audit_segment`, `create_custom_issue_rule`, `create_issue_mute_rule`, `create_issue_severity_override`, `delete_audit_segment`, `delete_custom_issue_rule`, `delete_issue_mute_rule`, `delete_issue_severity_override`, `https_report`, `internal_links`, `list_audit_segments`, `list_custom_issue_rules`, `list_issue_mute_rules`, `list_issue_severity_overrides`, `list_issue_statuses`, `segment`, `set_issue_status`, `start`, `status`, `structured_data_report`, `stream_events` (SSE) | Start a crawl, read status and comparisons, Core Web Vitals, triage rules, audit reports, and the live SSE progress stream. |
+| `seo.patches` | `batch_draft`, `disable_auto_publish`, `draft`, `enable_auto_publish`, `list`, `list_auto_publish_rules`, `publish`, `revert` | AI-drafted title/meta/canonical patches, publish/revert and auto-publish rules. |
+| `seo.log_analyzer` | `daily_summary`, `get_upload`, `list_uploads`, `top_paths`, `upload` | Server-log uploads and bot-traffic reports. |
+| `seo.web_analytics` | `devices`, `sources`, `summary`, `top_pages` | First-party, cookieless traffic and AI-referral reports. |
+
+### Rank tracking
+
+| Resource | Methods | What it covers |
+| --- | --- | --- |
+| `seo.rank_tracking` | `add_annotation`, `add_competitor`, `add_keywords`, `create`, `delete`, `get`, `get_ai_overview_trend`, `get_config_trend`, `get_keyword_history`, `get_latest_run`, `get_rank_movers`, `get_volatility_index`, `list_annotations`, `list_cannibalisation`, `list_competitors`, `list_configs`, `list_keyword_tags`, `remove_annotation`, `remove_competitor`, `remove_keywords`, `set_keyword_target_url`, `update`, `update_keyword_tag` | Trackers, keywords, tags, runs, trends, movers, annotations, cannibalisation, competitors. |
+| `seo.local_rank_grid` | `create_config`, `delete_config`, `get_latest_run`, `list_configs`, `run_check` | Geo-grid organic rank tracking. |
+| `seo.local_pack_rank` | `create_config`, `delete_config`, `get_latest_check`, `list_configs`, `run_check` | Local-pack position of a named business. |
+| `seo.brave_search` | `rank_check` | Rank checks against Brave Search's independent index. |
+
+### Local
+
+| Resource | Methods | What it covers |
+| --- | --- | --- |
+| `seo.local` | `business_listings`, `nap_audit`, `questions_answers` | Business listings, Q&A and NAP audit. |
+| `seo.google_business_profile` | `available_locations`, `create_post`, `delete_review_reply`, `get_connection`, `get_optimization`, `get_performance`, `get_profile`, `link`, `list_posts`, `list_reviews`, `reply_to_review`, `unlink` | Business Profile connection, profile, performance, reviews, posts, optimization. |
+
+### AI search visibility
+
+| Resource | Methods | What it covers |
+| --- | --- | --- |
+| `seo.ai_search` | `brand_lookup`, `brand_lookup_status`, `brand_scan_trend`, `citations`, `competitor_positioning`, `delete_brand_monitor`, `delete_tracked_prompt`, `list_brand_monitors`, `list_tracked_prompts`, `prompt_explorer`, `prompt_research`, `tracked_prompt_trend`, `upsert_brand_monitor`, `upsert_tracked_prompt` | Brand lookup, prompt explorer, brand monitors, tracked prompts, competitor positioning, prompt research, citations. |
+| `seo.direct_vendor_ai` | `answer` | Answers from vendors' own APIs (You.com, DeepSeek, xAI, Meta AI, MiniMax). |
+
+### Search engines and analytics
+
+| Resource | Methods | What it covers |
+| --- | --- | --- |
+| `seo.gsc` | `anonymous_queries`, `archive`, `cannibalisation`, `connect`, `content_decay`, `coverage`, `ctr_by_position`, `hourly`, `inspect_urls`, `performance`, `sitemaps` | Search Console performance, archive, coverage, URL inspection, sitemaps, reports. |
+| `seo.ga4` | `channels`, `connect`, `daily`, `disconnect`, `landing_pages`, `list_properties`, `set_property` | Google Analytics 4 connection and reports. |
+| `seo.bing` | `backlinks`, `connect`, `detail_stats`, `disconnect`, `get_feed_details`, `keyword_research`, `list_sites`, `save_crawl_settings`, `set_site`, `site_overview`, `submit_content`, `submit_feed`, `update_blocked_url`, `update_query_parameter`, `url_info`, `url_links` | Bing Webmaster: site overview, backlinks, keyword research, submissions, settings. |
+| `seo.yandex` | `connect`, `disconnect`, `list_hosts`, `reindex_url`, `set_host`, `site_overview` | Yandex Webmaster: site overview, re-index, connection. |
+| `seo.baidu` | `connection`, `disconnect`, `set_connection`, `submit_urls` | Baidu push API connection and URL submission. |
+| `seo.index_now` | `submit` | IndexNow URL submission. |
+| `seo.ahrefs` | `connect`, `disconnect`, `list_projects`, `set_project` | Ahrefs Connect project selection (inert until partner approval). |
+
+
+---
+
+## Client
+
+```ruby
+MisarSEO::Client.new(
+  api_key: "mseo_…",
+  base_url: "https://api.misar.io/seo", # default
+  timeout: 30,
+  max_retries: 2
+)
+```
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| base URL | `https://api.misar.io/seo` | API gateway. |
+| timeout | 30 s | Per request; a stream's wait covers only the response headers. |
+| max retries | 2 | Extra attempts for retryable failures (see [Retries](#retries)). |
+| retry delays | 250 ms base, 60 s cap | Exponential backoff with jitter; `Retry-After` honoured up to the cap. |
+
+---
+
+## Quick start
+
+```ruby
+project_id = seo.projects.list["projects"].first["id"]
+
+ideas = seo.keywords.research("projectId" => project_id, "keywords" => ["seo tools"])
+```
+
+---
+
+## Primary functions
+
+### Run a site audit and follow it live
+
+```ruby
+job = seo.crawl.start("projectId" => project_id, "startUrl" => "https://example.com")
+
+seo.crawl.stream_events(job["jobId"], project_id) do |frame|
+  puts "#{frame.event} #{frame.data}" # progress … then complete or error
+end
+```
+
+### Read a backlink profile
+
+```ruby
+profile = seo.backlinks.overview(project_id, "example.com")
+```
+
+---
+
+## Errors
+
+```ruby
+begin
+  seo.projects.get("nope")
+rescue MisarSEO::NotFoundError => e
+  puts e.code # "NOT_FOUND"
+rescue MisarSEO::Error => e
+  puts "#{e.status} #{e.code}"
+end
+```
+
+| Type | When |
+| --- | --- |
+| `MisarSEO::Error` | Base: `status`, `code`, `body`, `retry_after`, `not_found?`, `rate_limited?`. |
+| `MisarSEO::PlanLimitError` | `offer`, `reason`, `feature`, `plan`, `upgrade_url`. |
+| `ValidationError` … `NotFoundError`, `RateLimitError`, `UpstreamError`, `NetworkError` | 400–404, 429, 502–504, no response. |
+
+### Plan limits
+
+A call the organization's plan does not cover answers with
+
+```json
+{ "error": "...", "code": "plan_limit_exceeded", "upgrade": { "reason", "feature", "headline", "plans": [...], "urls": { "pricing" }, "cta" } }
+```
+
+- **402** — the feature is not in the plan, or a point-in-time cap (projects, API keys, tracked keywords) is reached.
+- **429** with `Retry-After` — a day/month quota is spent; it resets at the period rollover.
+
+Detection is by `code`, never by status: a quota block is a 429 and would otherwise look like an ordinary throttle. Every piece of copy — plan names, prices, what each plan unlocks, URLs — is in the offer, so render it rather than hard-coding any of it. `x-misar-plan` and `x-misar-upgrade-url` response headers carry the current plan and upgrade link.
+
+```ruby
+begin
+  seo.keywords.research("projectId" => project_id, "keywords" => ["seo"])
+rescue MisarSEO::PlanLimitError => e
+  puts e.offer["headline"], e.upgrade_url
+end
+```
+
+---
+
+## Retries
+
+- **429** is retried for every method (the limiter refuses before any work is done) — except a `plan_limit_exceeded` body, which is never retried.
+- **502/503/504 and network failures** are retried for GET only: a POST may already have started a billed crawl.
+- Exponential backoff from 250 ms with jitter; a `Retry-After` longer than the cap raises immediately instead of parking the caller.
+- 400/401/402/403/404/409 and 500/501 are never retried — they fail the same way every time.
+
+---
+
+## Pagination
+
+The API pages two ways: offset pages (`{ rows, hasMore, page }`, e.g. backlink anchors) and keyset pages (`{ rows, hasMore, nextCursor }`, e.g. the activity log, whose rows are under `entries`). The helpers stop on `hasMore: false`, on an empty page, or on a repeated cursor, so a shrinking result set cannot loop forever against a billed endpoint.
+
+```ruby
+anchors = MisarSEO::Pagination.collect_offset_pages do |page|
+  seo.backlinks.anchors(project_id, "example.com", query: { "page" => page })
+end
+```
+
+---
+
+## Streaming
+
+`crawl` progress is a Server-Sent Events stream (`GET /crawl/:jobId/stream`, `Accept: text/event-stream`): `progress` frames roughly every 1.5 s, then one terminal `complete` or `error`, after which the SDK ends the stream. It is never retried — replaying a stream would duplicate what was already consumed. See [Run a site audit](#run-a-site-audit-and-follow-it-live).
+
+---
+
+## Versioning
+
+Semantic versioning; see [CHANGELOG.md](./CHANGELOG.md). Every SDK is generated from the same `manifest.json` (API 1.1.0), so a method added to the API appears in all thirteen at once.
+
+---
+
+## Links
+
+- Product: https://seo.misar.io
+- API docs: https://docs.misar.io/seo
+- Issues: https://github.com/Misar-AI/misarseo-sdks/issues
+- Status: https://status.misar.io
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

data/lib/misarseo/client.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module MisarSEO
+  # MisarSEO API client. Every resource is a method named after it —
+  # +client.projects+, +client.rank_tracking+, +client.ai_search+ …
+  #
+  #   client = MisarSEO::Client.new(api_key: ENV["MISARSEO_API_KEY"])
+  #   client.projects.list
+  class Client
+    Generated::RESOURCES.each do |name, klass|
+      define_method(name) { @resources[name] ||= klass.new(@transport) }
+    end
+
+    # +api_key+ falls back to MISARSEO_API_KEY. +adapter+ replaces Net::HTTP (tests).
+    def initialize(api_key: nil, base_url: Transport::DEFAULT_BASE_URL, timeout: 30, max_retries: 2,
+                   retry_base_delay: 0.25, max_retry_delay: 60, adapter: nil)
+      key = api_key.to_s.empty? ? ENV["MISARSEO_API_KEY"].to_s : api_key
+      if key.empty?
+        raise ArgumentError, "A MisarSEO API key (mseo_...) is required: pass api_key: or set " \
+                             "MISARSEO_API_KEY; see https://seo.misar.io/ai"
+      end
+
+      @transport = Transport.new(api_key: key, base_url: base_url, timeout: timeout, max_retries: max_retries,
+                                 retry_base_delay: retry_base_delay, max_retry_delay: max_retry_delay,
+                                 adapter: adapter)
+      @resources = {}
+    end
+  end
+end

data/lib/misarseo/errors.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module MisarSEO
+  # The +code+ every Misar product sends on a plan-limit rejection.
+  PLAN_LIMIT_CODE = "plan_limit_exceeded"
+
+  # A non-2xx response, or (status 0) a request that never got one. +code+ is
+  # the API's own code — NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED …
+  class Error < StandardError
+    attr_reader :status, :code, :body, :retry_after
+
+    def initialize(status, code, message, body = nil, retry_after = nil)
+      @status = status
+      @code = code
+      @body = body
+      @retry_after = retry_after
+      super(status.zero? ? "misarseo: #{message}" : "misarseo: HTTP #{status} (#{code}): #{message}")
+    end
+
+    def not_found?
+      status == 404
+    end
+
+    def unauthorized?
+      status == 401
+    end
+
+    # An ordinary throttle — never true for a plan limit.
+    def rate_limited?
+      status == 429 && !is_a?(PlanLimitError)
+    end
+  end
+
+  class ValidationError < Error; end
+  class AuthenticationError < Error; end
+  class PaymentRequiredError < Error; end
+  class PermissionError < Error; end
+  class NotFoundError < Error; end
+  class RateLimitError < Error; end
+  class UpstreamError < Error; end
+  class NetworkError < Error; end
+
+  # The organization's plan does not cover the call: a feature its tier locks
+  # (402), a spent day/month quota (429 with Retry-After at the rollover) or a
+  # point-in-time cap such as projects (402). Never retried — show +offer+, or
+  # at least +upgrade_url+, to the user.
+  class PlanLimitError < Error
+    # The server's +upgrade+ Hash: plans, prices, URLs — all server-side copy.
+    attr_reader :offer
+    # Current plan slug (x-misar-plan, else the offer).
+    attr_reader :plan
+    # Where to upgrade (x-misar-upgrade-url, else the offer).
+    attr_reader :upgrade_url
+
+    def initialize(status, message, body, retry_after, plan_header, upgrade_url_header)
+      upgrade = body.is_a?(Hash) ? body["upgrade"] : nil
+      @offer = upgrade.is_a?(Hash) ? upgrade : nil
+      @plan = plan_header || dig(@offer, "current_plan", "slug")
+      @upgrade_url = upgrade_url_header || dig(@offer, "urls", "pricing")
+      super(status, PLAN_LIMIT_CODE, message, body, retry_after)
+    end
+
+    # quota_exhausted, feature_locked …
+    def reason
+      dig(@offer, "reason")
+    end
+
+    # Machine key of the limit that was hit.
+    def feature
+      dig(@offer, "feature")
+    end
+
+    private
+
+    def dig(hash, *path)
+      path.reduce(hash) { |cur, key| cur.is_a?(Hash) ? cur[key] : nil }
+    end
+  end
+
+  STATUS_ERRORS = {
+    400 => ValidationError, 401 => AuthenticationError, 402 => PaymentRequiredError,
+    403 => PermissionError, 404 => NotFoundError, 429 => RateLimitError,
+    502 => UpstreamError, 503 => UpstreamError, 504 => UpstreamError
+  }.freeze
+
+  # The error for a non-2xx response. The plan-limit code is checked BEFORE the
+  # status: a spent quota is a 429 that otherwise looks like an ordinary throttle.
+  def self.error_from(status, headers, body)
+    data = body.is_a?(Hash) ? body : {}
+    message = (data["error"] || data["message"] || "HTTP #{status}").to_s
+    code = (data["code"] || "API_ERROR").to_s
+    h = headers.each_with_object({}) { |(k, v), acc| acc[k.to_s.downcase] = v.is_a?(Array) ? v.first : v }
+    retry_after = h["retry-after"].to_s.strip =~ /\A\d+\z/ ? h["retry-after"].to_i : nil
+    if code == PLAN_LIMIT_CODE
+      return PlanLimitError.new(status, message, body, retry_after, h["x-misar-plan"], h["x-misar-upgrade-url"])
+    end
+
+    STATUS_ERRORS.fetch(status, Error).new(status, code, message, body, retry_after)
+  end
+end

data/lib/misarseo/generated/account.rb

@@ -0,0 +1,30 @@
+# AUTO-GENERATED by scripts/generate-sdks.mjs from sdks/manifest.json.
+# Do not edit by hand: changes are overwritten. To change this surface,
+# change the API route and its registry entry, run `pnpm sdk:sync`, then
+# `pnpm sdk:generate`.
+
+module MisarSEO
+  module Generated
+    # +client.account+ — 3 endpoint(s).
+    class AccountResource
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # DELETE /account/delete
+      def delete(body = nil, query: nil, **fields)
+        @transport.request("DELETE", "/account/delete", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /account/delete
+      def delete_via_post(body = nil, query: nil, **fields)
+        @transport.request("POST", "/account/delete", query: query, body: Transport.body(body, fields))
+      end
+
+      # GET /account/export
+      def export(query: nil)
+        @transport.request("GET", "/account/export", query: query, body: nil)
+      end
+    end
+  end
+end

data/lib/misarseo/generated/activity.rb

@@ -0,0 +1,22 @@
+# AUTO-GENERATED by scripts/generate-sdks.mjs from sdks/manifest.json.
+# Do not edit by hand: changes are overwritten. To change this surface,
+# change the API route and its registry entry, run `pnpm sdk:sync`, then
+# `pnpm sdk:generate`.
+
+module MisarSEO
+  module Generated
+    # +client.activity+ — 1 endpoint(s).
+    class ActivityResource
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # GET /activity
+      #
+      # Optional query parameters: +before+, +pageSize+, +projectId+.
+      def list(query: nil)
+        @transport.request("GET", "/activity", query: query, body: nil)
+      end
+    end
+  end
+end

data/lib/misarseo/generated/ahrefs.rb

@@ -0,0 +1,35 @@
+# AUTO-GENERATED by scripts/generate-sdks.mjs from sdks/manifest.json.
+# Do not edit by hand: changes are overwritten. To change this surface,
+# change the API route and its registry entry, run `pnpm sdk:sync`, then
+# `pnpm sdk:generate`.
+
+module MisarSEO
+  module Generated
+    # +client.ahrefs+ — 4 endpoint(s).
+    class AhrefsResource
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # GET /ahrefs/connection
+      def connect(project_id, query: nil)
+        @transport.request("GET", "/ahrefs/connection", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # DELETE /ahrefs/connection
+      def disconnect(body = nil, query: nil, **fields)
+        @transport.request("DELETE", "/ahrefs/connection", query: query, body: Transport.body(body, fields))
+      end
+
+      # GET /ahrefs/projects
+      def list_projects(project_id, query: nil)
+        @transport.request("GET", "/ahrefs/projects", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # POST /ahrefs/connection
+      def set_project(body = nil, query: nil, **fields)
+        @transport.request("POST", "/ahrefs/connection", query: query, body: Transport.body(body, fields))
+      end
+    end
+  end
+end

data/lib/misarseo/generated/ai_search.rb

@@ -0,0 +1,87 @@
+# AUTO-GENERATED by scripts/generate-sdks.mjs from sdks/manifest.json.
+# Do not edit by hand: changes are overwritten. To change this surface,
+# change the API route and its registry entry, run `pnpm sdk:sync`, then
+# `pnpm sdk:generate`.
+
+module MisarSEO
+  module Generated
+    # +client.ai_search+ — 14 endpoint(s).
+    class AiSearchResource
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # POST /ai/brand-lookup
+      def brand_lookup(body = nil, query: nil, **fields)
+        @transport.request("POST", "/ai/brand-lookup", query: query, body: Transport.body(body, fields))
+      end
+
+      # GET /ai/brand-lookup/:jobId/status
+      def brand_lookup_status(job_id, project_id, query: nil)
+        @transport.request("GET", "/ai/brand-lookup/#{Transport.seg(job_id)}/status", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # GET /ai/brand-scan-trend
+      #
+      # Optional query parameters: +since+.
+      def brand_scan_trend(project_id, target, query: nil)
+        @transport.request("GET", "/ai/brand-scan-trend", query: Transport.merge(query, "projectId" => project_id, "target" => target), body: nil)
+      end
+
+      # POST /citations
+      def citations(body = nil, query: nil, **fields)
+        @transport.request("POST", "/citations", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /ai/competitor-positioning
+      def competitor_positioning(body = nil, query: nil, **fields)
+        @transport.request("POST", "/ai/competitor-positioning", query: query, body: Transport.body(body, fields))
+      end
+
+      # DELETE /ai/brand-monitors/:monitorId
+      def delete_brand_monitor(monitor_id, project_id, query: nil)
+        @transport.request("DELETE", "/ai/brand-monitors/#{Transport.seg(monitor_id)}", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # DELETE /ai/prompt-tracking/:trackedPromptId
+      def delete_tracked_prompt(tracked_prompt_id, project_id, query: nil)
+        @transport.request("DELETE", "/ai/prompt-tracking/#{Transport.seg(tracked_prompt_id)}", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # GET /ai/brand-monitors
+      def list_brand_monitors(project_id, query: nil)
+        @transport.request("GET", "/ai/brand-monitors", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # GET /ai/prompt-tracking
+      def list_tracked_prompts(project_id, query: nil)
+        @transport.request("GET", "/ai/prompt-tracking", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # POST /ai/prompt-explorer
+      def prompt_explorer(body = nil, query: nil, **fields)
+        @transport.request("POST", "/ai/prompt-explorer", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /ai/prompt-research
+      def prompt_research(body = nil, query: nil, **fields)
+        @transport.request("POST", "/ai/prompt-research", query: query, body: Transport.body(body, fields))
+      end
+
+      # GET /ai/prompt-tracking/:trackedPromptId/trend
+      def tracked_prompt_trend(tracked_prompt_id, project_id, query: nil)
+        @transport.request("GET", "/ai/prompt-tracking/#{Transport.seg(tracked_prompt_id)}/trend", query: Transport.merge(query, "projectId" => project_id), body: nil)
+      end
+
+      # POST /ai/brand-monitors
+      def upsert_brand_monitor(body = nil, query: nil, **fields)
+        @transport.request("POST", "/ai/brand-monitors", query: query, body: Transport.body(body, fields))
+      end
+
+      # POST /ai/prompt-tracking
+      def upsert_tracked_prompt(body = nil, query: nil, **fields)
+        @transport.request("POST", "/ai/prompt-tracking", query: query, body: Transport.body(body, fields))
+      end
+    end
+  end
+end

data/lib/misarseo/generated/backlinks.rb

@@ -0,0 +1,34 @@
+# AUTO-GENERATED by scripts/generate-sdks.mjs from sdks/manifest.json.
+# Do not edit by hand: changes are overwritten. To change this surface,
+# change the API route and its registry entry, run `pnpm sdk:sync`, then
+# `pnpm sdk:generate`.
+
+module MisarSEO
+  module Generated
+    # +client.backlinks+ — 3 endpoint(s).
+    class BacklinksResource
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # GET /backlinks/anchors
+      #
+      # Optional query parameters: +page+, +pageSize+, +scope+, +sortField+, +sortOrder+.
+      def anchors(project_id, target, query: nil)
+        @transport.request("GET", "/backlinks/anchors", query: Transport.merge(query, "projectId" => project_id, "target" => target), body: nil)
+      end
+
+      # POST /backlinks/intersect
+      def intersect(body = nil, query: nil, **fields)
+        @transport.request("POST", "/backlinks/intersect", query: query, body: Transport.body(body, fields))
+      end
+
+      # GET /backlinks
+      #
+      # Optional query parameters: +scope+.
+      def overview(project_id, target, query: nil)
+        @transport.request("GET", "/backlinks", query: Transport.merge(query, "projectId" => project_id, "target" => target), body: nil)
+      end
+    end
+  end
+end