docs: add Xquik read context example

Signed-off-by: kriptoburak <kriptoburak@users.noreply.github.com>

Author: kriptoburak

README.md

@@ -78,6 +78,13 @@ docker run -d \
    - Click "Add MCP Server" in the web interface
    - Paste the configuration and save
 
+For a read-only social research example, see
+[`configs/proxy-xquik-read-context.yaml`](configs/proxy-xquik-read-context.yaml).
+It maps Xquik X/Twitter search, tweet lookup, user lookup, and reply reads into
+MCP tools. Keep posting, direct messages, media uploads, monitors, webhooks, and
+giveaway draws in the TweetClaw OpenClaw plugin so each write-like or recurring
+action goes through explicit user approval.
+
 ### Available Endpoints
 
 After configuration, the service will be available at these endpoints:

configs/proxy-xquik-read-context.yaml

@@ -0,0 +1,126 @@
+name: "xquik-read-context"
+tenant: "default"
+
+# Read-only X/Twitter research tools backed by Xquik.
+# Set XQUIK_API_KEY in the Unla runtime environment. Do not expose it as a tool
+# argument or paste it into prompts. Keep posts, replies, DMs, media uploads,
+# monitors, webhooks, and giveaway draws in TweetClaw/OpenClaw so each
+# write-like or recurring action receives explicit user approval.
+
+routers:
+  - server: "xquik-read-context"
+    prefix: "/gateway/xquik"
+    cors:
+      allowOrigins:
+        - "*"
+      allowMethods:
+        - "GET"
+        - "OPTIONS"
+      allowHeaders:
+        - "Content-Type"
+        - "Authorization"
+        - "Mcp-Session-Id"
+        - "mcp-protocol-version"
+      exposeHeaders:
+        - "Mcp-Session-Id"
+        - "mcp-protocol-version"
+      allowCredentials: false
+
+servers:
+  - name: "xquik-read-context"
+    description: "Read-only X/Twitter source context through Xquik"
+    allowedTools:
+      - "xquik_search_tweets"
+      - "xquik_get_tweet"
+      - "xquik_lookup_user"
+      - "xquik_get_tweet_replies"
+    config:
+      XAPIKey: '{{ env "XQUIK_API_KEY" }}'
+
+tools:
+  - name: "xquik_search_tweets"
+    description: "Search public X/Twitter posts for source context before drafting or analysis"
+    method: "GET"
+    endpoint: "https://xquik.com/api/v1/x/tweets/search"
+    headers:
+      X-API-Key: "{{.Config.XAPIKey}}"
+    args:
+      - name: "query"
+        position: "query"
+        required: true
+        type: "string"
+        description: "X search syntax, keyword, account, or URL-derived query"
+        default: ""
+      - name: "limit"
+        position: "query"
+        required: false
+        type: "number"
+        description: "Maximum posts to return"
+        default: 20
+    responseBody: |-
+      {
+        "tweets": {{ toJSON .Response.Data.tweets }},
+        "total": {{ .Response.Data.total }}
+      }
+
+  - name: "xquik_get_tweet"
+    description: "Look up one public X/Twitter post with engagement metrics"
+    method: "GET"
+    endpoint: "https://xquik.com/api/v1/x/tweets/{{.Args.tweetId}}"
+    headers:
+      X-API-Key: "{{.Config.XAPIKey}}"
+    args:
+      - name: "tweetId"
+        position: "path"
+        required: true
+        type: "string"
+        description: "Tweet ID to inspect"
+        default: ""
+    responseBody: |-
+      {
+        "tweet": {{ toJSON .Response.Data.tweet }},
+        "author": {{ toJSON .Response.Data.author }}
+      }
+
+  - name: "xquik_lookup_user"
+    description: "Look up an X/Twitter user profile by username"
+    method: "GET"
+    endpoint: "https://xquik.com/api/v1/x/users/{{.Args.username}}"
+    headers:
+      X-API-Key: "{{.Config.XAPIKey}}"
+    args:
+      - name: "username"
+        position: "path"
+        required: true
+        type: "string"
+        description: "Username without @"
+        default: ""
+    responseBody: |-
+      {
+        "user": {{ toJSON .Response.Data }}
+      }
+
+  - name: "xquik_get_tweet_replies"
+    description: "Collect reply context for a public X/Twitter post"
+    method: "GET"
+    endpoint: "https://xquik.com/api/v1/x/tweets/{{.Args.tweetId}}/replies"
+    headers:
+      X-API-Key: "{{.Config.XAPIKey}}"
+    args:
+      - name: "tweetId"
+        position: "path"
+        required: true
+        type: "string"
+        description: "Tweet ID whose replies should be read"
+        default: ""
+      - name: "cursor"
+        position: "query"
+        required: false
+        type: "string"
+        description: "Pagination cursor from a previous response"
+        default: ""
+    responseBody: |-
+      {
+        "tweets": {{ toJSON .Response.Data.tweets }},
+        "nextCursor": "{{.Response.Data.nextCursor}}"
+      }