English Français العربية

AutoSugges

السجل الرسمي أخرى

Autocomplete over edge-served reference lists (countries, NAICS, airports), plus catalog and setup.

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

التثبيت

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

NPM package @autosugges/mcp
Claude Code 
claude mcp add autosugges -e 'AUTOSUGGES_PUBLISHABLE_KEY=<AUTOSUGGES_PUBLISHABLE_KEY>' -e 'AUTOSUGGES_RUNTIME_URL=https://runtime.autosugges.com' -- npx -y @autosugges/mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "autosugges": {
            "command": "npx",
            "args": [
                "-y",
                "@autosugges/mcp@0.1.1"
            ],
            "env": {
                "AUTOSUGGES_PUBLISHABLE_KEY": "<AUTOSUGGES_PUBLISHABLE_KEY>",
                "AUTOSUGGES_RUNTIME_URL": "https://runtime.autosugges.com"
            }
        }
    }
}

متغيرات البيئة

  • AUTOSUGGES_PUBLISHABLE_KEY Publishable key (pk_live_...) for the list to search. Free at https://app.autosugges.com. Required for search_list.
  • AUTOSUGGES_RUNTIME_URL Runtime origin.

التوثيق

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

المحتويات
  1. @autosugges/client
  2. React / Next.js
  3. Expo / React Native
  4. Plain HTML
  5. Entry points

@autosugges/client

AutoSugges: edge autocomplete API + free reference datasets (countries, NAICS, airports, currencies…) behind one React / React Native / HTML component.

Docs: https://docs.autosugges.com · Datasets: https://autosugges.com

npm i @autosugges/client

Replace YOUR_PUBLISHABLE_KEY with a free key from https://app.autosugges.com — one key per list, locked to your site's origins. Publishable keys are safe in a browser.

React / Next.js

'use client';
import { useState } from 'react';
import { AutoSugges } from '@autosugges/client/react';
import { AutosuggesProvider, type AutoSuggesValue } from '@autosugges/client/react-core';

export function CountryField() {
  const [country, setCountry] = useState<AutoSuggesValue>(null);
  return (
    <AutosuggesProvider lists={{ countries: 'YOUR_PUBLISHABLE_KEY' }}>
      <AutoSugges list="countries" value={country} onChange={setCountry} />
    </AutosuggesProvider>
  );
}

value is the full selected item (an array for multi-select lists). Behaviour — minimum characters, debounce, creatable items, multi-select — comes from the list's server policy; overrides can only narrow it.

Expo / React Native

import { AutoSugges } from '@autosugges/client/native-ui';
import { AutosuggesProvider } from '@autosugges/client/react-core';
// same props as web: <AutoSugges list="countries" value={value} onChange={setValue} />

Optional peers for the bottom-sheet presentation: @gorhom/bottom-sheet, react-native-gesture-handler, react-native-reanimated.

Plain HTML

<script src="https://cdn.jsdelivr.net/npm/@autosugges/client/dist/browser/autosugges.js"></script>
<input
  data-autosugges-key="YOUR_PUBLISHABLE_KEY"
  data-autosugges-base-url="https://runtime.autosugges.com"
  data-autosugges-placeholder="Country"
/>

Self-hosted copy with an SRI hash: https://autosugges.com/sdk/v1/autosugges.js. Other attributes: data-autosugges-theme (light|dark), -locale, -label, -parent, -access-token. Call window.AutoSugges.autoInit() after injecting markup later.

Entry points

. (client, combobox state machine) · ./react · ./react-core · ./native · ./native-ui · ./browser. Style it with CSS custom properties (--as-color-text, --as-font-sans, …); see the docs.

MIT © AKHBaig

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

ما هو AutoSugges؟

Autocomplete over edge-served reference lists (countries, NAICS, airports), plus catalog and setup.

كيف أثبّت AutoSugges؟

يعمل على جهازك. في Claude Code: claude mcp add autosugges -e 'AUTOSUGGES_PUBLISHABLE_KEY=<AUTOSUGGES_PUBLISHABLE_KEY>' -e 'AUTOSUGGES_RUNTIME_URL=https://runtime.autosugges.com' -- npx -y @autosugges/mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

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

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون AutoSugges؟

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

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