English Français العربية

Howseen

السجل الرسمي التسويق والمبيعات

How ChatGPT, Gemini, Perplexity and Google AI name your brand, cite sources and rank rivals.

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع Howseen؟

  • "What is my AI visibility this month, per engine?"
  • "On which buyer questions does ChatGPT name a competitor and not us?"
  • "Which sites does AI cite when we lose? Where should we get listed first?"
  • "What changed since the last scan?"
  • "Draft an article for the question we lose the most, then publish it to our site."

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http howseen 'https://app.howseen.ai/api/mcp' --header 'Authorization: <Bearer token: your Howseen API key (Settings > API & AI assistants), as '\''Bearer hs_live_...'\''>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "howseen": {
            "type": "http",
            "url": "https://app.howseen.ai/api/mcp",
            "headers": {
                "Authorization": "<Bearer token: your Howseen API key (Settings > API & AI assistants), as 'Bearer hs_live_...'>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Howseen MCP server
  2. Connect your AI assistant
  3. What you can ask
  4. Tools
  5. REST API
  6. Pricing
  7. Support

Howseen MCP server

Ask Claude, ChatGPT, Cursor or Codex how your brand shows up in AI answers, and act on it, without leaving your AI assistant.

Howseen tracks which brands ChatGPT, Gemini, Perplexity, Google AI Overviews and Google AI Mode recommend on the questions your buyers ask, which sources those engines cite, and writes the content to win the spots you are missing. This repository documents its remote MCP server.

  • Server URL: https://app.howseen.ai/api/mcp (Streamable HTTP, remote, nothing to install)
  • Auth: Authorization: Bearer <your Howseen API key>
  • Docs: https://howseen.ai/mcp
  • Get a key: Howseen dashboard > Settings > API & AI assistants (3-day free trial)

Connect your AI assistant

Replace hs_live_YOUR_KEY with your key.

Claude Code

claude mcp add --scope user --transport http howseen https://app.howseen.ai/api/mcp --header "Authorization: Bearer hs_live_YOUR_KEY"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "howseen": {
      "url": "https://app.howseen.ai/api/mcp",
      "headers": { "Authorization": "Bearer hs_live_YOUR_KEY" }
    }
  }
}

Codex

export HOWSEEN_API_KEY=hs_live_YOUR_KEY
codex mcp add howseen --url https://app.howseen.ai/api/mcp --bearer-token-env-var HOWSEEN_API_KEY

Claude.ai and ChatGPT (custom connector): these apps can only send the key inside the URL.

https://app.howseen.ai/api/mcp?key=hs_live_YOUR_KEY

Treat that URL like a password: do not share it or show it on screen, and revoke the key in Settings if it leaks.

What you can ask

  • "What is my AI visibility this month, per engine?"
  • "On which buyer questions does ChatGPT name a competitor and not us?"
  • "Which sites does AI cite when we lose? Where should we get listed first?"
  • "What changed since the last scan?"
  • "Draft an article for the question we lose the most, then publish it to our site."

Tools

Read (any key)

ToolWhat it returns
list_brandsThe brands (websites) tracked in the account
get_visibility% of AI answers that name the brand, share of voice, average position, sentiment, per engine, with the trend
list_promptsTracked buyer questions with per-question visibility, engines and cited domains
get_competitorsBrand vs competitors in AI answers, overall and per engine
get_top_sourcesDomains and URLs AI engines cite most on the brand's questions
search_responsesReal AI answers, with excerpts, brands named and cited URLs
get_action_planPrioritized actions to raise AI visibility
get_prompt_gapsQuestions where AI names a competitor but not the brand
get_easiest_winsThird-party pages cited in the answers the brand loses, ranked
get_changesWhat changed between the last two scans
suggest_promptsBuyer questions worth tracking that are not tracked yet
list_articlesArticles Howseen wrote for the brand, with status and URL
get_article_performancePublished articles with indexing status, impressions and clicks
get_usagePlan, quotas used and left, API limits

Actions (key with actions enabled; every action previews first and only applies with confirm: true)

add_prompts, archive_prompts, remove_prompts, add_competitor, remove_competitor, mark_action_done, dismiss_action, draft_article, refresh_article, publish_article, request_indexing, create_share_report, delete_article, restore_article.

publish_article sends a written article to the brand's connected site (WordPress, Shopify, Ghost, BigCommerce, webhook) or its Howseen-hosted blog.

REST API

The same data is available as a read-only JSON API:

curl -H "Authorization: Bearer hs_live_YOUR_KEY" https://app.howseen.ai/api/v1/brands
curl -H "Authorization: Bearer hs_live_YOUR_KEY" "https://app.howseen.ai/api/v1/brands/BRAND_ID/visibility?from=2026-09-01&engine=chatgpt"

Pricing

The MCP server and the API are included in the Pro plan (79 € a month) and the Business plans, and in the 3-day free trial. See https://howseen.ai/pricing.

Support

Questions or issues: open an issue here or write to raphael@howseen.ai.

الأسئلة الشائعة

ما هو Howseen؟

How ChatGPT, Gemini, Perplexity and Google AI name your brand, cite sources and rank rivals.

كيف أثبّت Howseen؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http howseen 'https://app.howseen.ai/api/mcp' --header 'Authorization: <Bearer token: your Howseen API key (Settings > API & AI assistants), as '\''Bearer hs_live_...'\''>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Howseen إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل Howseen مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Howseen؟

ينشره howseen-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.