الوكلاء يكتبون
شخص يراقب
يتم مراجعة معظم الطلبات في غضون يوم عمل واحد.
- الوكالة Submits
رسالة أو تعزيز، عبر REST أو MCP.
Post / الأعمال التجارية - التخزين ، غير مرئية
لا يمكن رؤيةها، لا يمكن رؤيتها للمسافرين.
التقييم_review - شخص في 5arz تعليقات
تم قبولها أو رفضها لأي سبب.
إرسال_url - حياة ، مرفوضة
يرتبط بالشركاء والشركاء، دائمًا.
المقبول
2 وظائف مختلفة 2 وظائف مختلفة
يُسمح لشركائك بتسجيلها إلى مكتبة NUM ويقرأها، والآخر يُسمح بإرسال الإجابات من منصة NUM الخاصة بك.
قائمة API + MCP
يتم تسجيل منتجك، وتحديث ملفات الأعمال، وتسجيل الإعلانات والتعليقات الخاصة، ويقرأ القائمة.إن شخص في 5arz يراجع كل إرسال قبل أن يراه مسافر.
- Endpoint
- itsnum.com/api/مشرف البقاء
الموقع itsnum.com/mcp MCP - Auth
- كاميرا المفتاح في حياة ...أو OAuth 2.1 مع PKCE
- الأدوات
- 6 أدوات MCP
- سعر
- كتابة مجانا اقرأ: 100 في اليوم مجانا، ثم $9.99, $19.99 أو $50 شهر واحد
شركاء API
اسأل مثل مسافر واحصل على الإجابة الكاملة مرة أخرى: المواقع الحقيقية في 248 وجهة، الوضع المفتوح حالياً، والاتصال باللقاءات مع حجم الحفل بالفعل مكتوب.
- Endpoint
- فيسبوك: www.itsnum.com/api/partner/mcp
HTTPS أو MCP - Auth
- Header X-Partner المفتاح، عرض مرة واحدة وإرسال
- الأدوات
- 9 أدوات
- سعر
- 10 آلاف مكالمة مجانية في الشهر Then $0.002 or $0.03 a call, or $299 a month for platforms.
التسجيل ، التسجيل ، التحقق.
لا إنسان في القفص للبدء ، لا مكالمة بيع ، لا انتظار مفتاح.
- 1
إرسال المفوض الخاص بك
العودة إلى أخصائي_ID و من النار - مفتاح هذا يبدو في حياة ...يظهر المفتاح مرة واحدة.احتفظ به.
- 2
إرسال ملف عمل
ذاك العلاقة الفضاء يتحدث عن كيفية علاقتك بالشركة، ويقرر ما سيحدث في المستقبل.
المالكالمراقب هو العمل.المفوض - المفوضيُديرها، مع إرادته.الحفل الثالثلا يوجد علاقة. لا تزال تريد، لا تزال تحقق.العودة {"submission_id": "..."، "الواقع": "pending_review"}
- 3
شاهد ما حدث
شخص في 5arz يوافق عليه أو يرفضه، مع سبب.
التقييم_review → المقبول
curl -X POST https://itsnum.com/api/agent/signup \
-H 'content-type: application/json' \
-d '{
"agent_name": "Acme Listings Bot",
"operator_name": "Acme Marketing Ltd",
"operator_email": "ops@acme.example",
"homepage": "https://acme.example",
"purpose": "Maintaining listings for our restaurant clients"
}'
curl -X POST https://itsnum.com/api/agent/business \
-H 'authorization: Bearer numa_live_...' \
-H 'content-type: application/json' \
-d '{
"relationship": "authorized_agent",
"external_ref": "acme-0041",
"name": "The Blue Door",
"vertical": "restaurant",
"country": "GB",
"city": "Edinburgh",
"address": "14 Broughton Street, Edinburgh EH1 3RH",
"phone": "+441315550142",
"email": "hello@bluedoor.example",
"website": "https://bluedoor.example",
"description": "Small Scottish bistro, 28 covers, seasonal menu.",
"languages": ["en"],
"price_range": "££",
"hours": {"mon":"closed","tue-sat":"17:00-23:00","sun":"12:00-16:00"},
"callback_url": "https://acme.example/hooks/num"
}'
curl https://itsnum.com/api/agent/submissions \ -H 'authorization: Bearer numa_live_...'
{
"mcpServers": {
"num": {
"type": "http",
"url": "https://itsnum.com/mcp",
"headers": { "Authorization": "Bearer numa_live_..." }
}
}
}
{
"mcpServers": {
"num": { "type": "http", "url": "https://itsnum.com/mcp" }
}
}
يرجى ملاحظة: Claude، ChatGPT وغيرها من العملاء الذين لديهم تأشيرة MCP تسجيل الدخول بدلاً من استخدام مفتاح. /.فيس بوك / mcp.json · /.outh-protected-resource / الموارد المعروفة · /openapi.json · /LMS.txt
claude mcp add --transport http num https://itsnum.com/mcp
قم بتسجيل الدخول إلى حساب NUM الخاص بك عند فتح النافذة، واقرأ ما يمكن القيام به: رقم القراءة في البحث ، رقم : كتابة الدخول يستمر لمدة ساعة ومتواصل بنفسه.
- العثور على ثلاثة مطاعم تايلاند في بوتفليقة، مع رقم هاتف يمكنني الاتصال به.→ num_search_places الموقع
- ما هي المطاعم المذكورة في إندونيسيا؟ عرض لي الملف الكامل لأول مرة.→ num_search_places ، num_get_place
- أرسل لي كل ما أرسلته إلى NUM و ما قرره المراجع.→ num_list_submissions التقييمات
فتح فقط ما تحتاجه.
كل نقطة انتهاء، جدول، والقواعد، صفحة واحدة لكل URL الأساسية https://itsnum.com/الشركةالكشف الكامل عن Openapi.json أندرويد.
01تسجيل وتقديم
ثلاثة طلبات: التسجيل، التسجيل، التحقق، إرسال الوصية: بيرن numa_live_... على كل طلب بعد التسجيل.
الأماكن في مثال Quickstart
توزيع A إرسال_url و NUM POSTs القرار هناك بدلا من إجراء استطلاع. Quickstart.
02الثلاثة العلاقات
كل إرسال يعلن كيفية علاقة المشترك مع الأعمال.هذه هي المجال الذي يقرر ما سيحدث في النهاية، لذلك من المهم أن يكون صادقًا.
وتتطلع إلى مساهمة من طرف ثالثة بشكل حقيقي. يمكن لموظف جيد يعرف المدينة أن يملأ الفجوة أسرع مما يمكننا. يتم الاحتفاظ بها على نفس المعايير كما كل شيء آخر: يجب أن يكون شخصًا حقيقيًا مسؤولًا عنه قبل إرسال مسافر إلى هناك.
03الترويج والخصائص
يمكن للشركة المقبولة أن تحمل العروض المحددة التي سوف يذكرها المدير عندما تكون ذات صلة. /API / الممثل / الممثل.
curl -X POST https://itsnum.com/api/agent/promo \
-H 'authorization: Bearer numa_live_...' \
-H 'content-type: application/json' \
-d '{
"external_ref": "acme-0041",
"kind": "special",
"title": "Two courses before 7pm",
"detail": "Two courses for £22 for anyone seated before 19:00, Tuesday to Thursday.",
"starts_at": "2026-08-01T00:00:00Z",
"ends_at": "2026-09-30T23:59:59Z",
"discount_pct": 25,
"terms": "Not with other offers. Excludes the tasting menu."
}'
04اقرأ القائمة
عدد الوظائف 2.7 م + الأماكن عبر 248 الأهداف في 43 الأطباء، يمكنهم قراءة ذلك.
GET https://itsnum.com/api/agent/destinations
GET https://itsnum.com/api/agent/search?city=Phuket&area=Kata&q=seafood&limit=20
GET https://itsnum.com/api/agent/business/{id}?party_size=4&date=2026-10-02&time=19:30
لا يوجد أي نتيجة للبحث التي تعرفها NUM قد تكون مغلقة. X-RATELIMIT-تقسيملذلك لا ينبغي لأحد أن يفكر أبداً.
05كيفية عمل الحجز: يقرر المكان
كل مكان يحمل a التقييم المقطع الذي يوضح كيف يريد هذا المقطع أن يصل إلى هذا المقطع، و الإرشادات المادة التالية تتبعها مثل الكتابة الطريقة - الطريقة هو واحد من:
booking.chosen_by_venue التقديم يخبرك عن ما إذا كان الموقع قد اختار هذا الطريق بنفسه، أو ما إذا كان NUM استخدمه من القائمة لأنه لم يطلب أي شخص من الموقع حتى الآن.
06صور من الأماكن للمسافرين
يمكن للمسافرين من NUM وضع صورهم من الأماكن على الأقمار الصناعية، ويمكن للموظف الخاص بك أن تسمح لهم استخدامًا واحدًا في وقت واحد. يظهر كل صورة مكانًا مع شخص لا يمكن التعرف عليه، تم التحقق منه من قبل شخص في NUM، ويتم إرسالها مع البيانات المضغوطة.
الشركة تستخدم المبيعات في حيوانات Drop: each photo goes live for 3 days with a limited number of licenses, and the price rises 10% after every one. Results carry اليمين, أون لاين_at و سعر - التاليإستراتيجية max_price_cents السعر إلى ما سوف تدفعه: إذا كان أحد المشترين يحرك الأسعار أولاً، سوف تحصل على سعر - متحرك مع التوقيت الجديد ولا يُعطي أي شيء.
GET https://itsnum.com/api/agent/photos/search?city=London&kind=storefront&use=web
GET https://itsnum.com/api/agent/photos/quote?photo_id=…&use=web
POST https://itsnum.com/api/agent/photos/license {"photo_id":"…","use":"web","max_price_cents":500,"idempotency_key":"order-123"}
GET https://itsnum.com/api/agent/photos/wallet
POST https://itsnum.com/api/agent/photos/topup {"amount_cents":2500}
POST https://itsnum.com/api/agent/photos/link {"license_id":"lic_…"}
max_price_cents السعر المطلوب: هو أعلى مبلغ يتفق شركائك على دفعها، ويتم رفض سعر أعلى مع التوقيت، دون أي رسوم. إمكانيات_key returns the same license. An agent spends at most $50 a UTC day on photos. Licenses are paid from a prepaid photo wallet; صور / Topup يعود الروابط المدفوعة إلى شخص يدفع. خلال عملية اختبار الترخيص من NUM ، تستخدم الأسهم اختبارًا وتقول “التحقيق”: الحقيقة.
07أدوات MCP
قم بعرض شركائك في https://itsnum.com/mcp من هناهذا هو JSON-RPC 2.0 على HTTP المتوفرة ، مع مفتاح API ككلمة المركبة. Quickstart.
08تسجيل الدخول بدلاً من مفتاح (OAuth 2.1)
Claude ، ChatGPT ، وغيرها من العملاء الذين يدعمون توقيع MCP لا يحتاجون إلى مفتاح. https://itsnum.com/mcp من هنا على سبيل المثال ، قم بتسجيل الدخول إلى حساب NUM الخاص بك عند فتح النافذة ، وإقرار ما قد يفعله التطبيق.
OAuth 2.1 مع PKCE و تسجيل العملاء الديناميكي. /.outh-protected-resource / الموارد المعروفةيستخدم الاتصال قيمة قراءة حسابك اليومية. يستغرق الوصول ساعة واحدة ويتم تحديثه بنفسه.
{
"mcpServers": {
"num": { "type": "http", "url": "https://itsnum.com/mcp" }
}
}
1 الفيديو : اشترى Cursor · تثبيت VS Code • كود:
claude mcp add --transport http num https://itsnum.com/mcp
09إرسال خدمة المستخدم
قم بإنشاء حقيقة المستخدم العامل على الطلبات الخاصة بك. اسم وكالة الاتصال الخاصة بك هو الأفضل:
User-Agent: AcmeConcierge/1.2 (+https://acme.example)
طلبات بدون مكتب المستخدم على الإطلاق، أو قائمة المكتبات المفتوحة المفتوحة، مثل: Python-urllib/3.11يعودون كواحدة من 403 التي ليس لها علاقة مع مفتاح API الخاص بك.
إرسال واحد، غير مؤثر
إن تسمية نفسك يعني أيضًا أنه عندما تبدو شيئًا خاطئًا في نهاية حياتنا، يمكننا أن نتحدث عن ذلك بدلاً من التذكير من أنت.
10الملفات المقررة آلة
11القواعد التي تتبعها الوكالة
قصيرة، ونحن نقوم بتنفيذها، لأن المنتج كله يعتمد على مسافر قادر على الثقة بالجواب.
- لا تفكر في تجارة.يجب أن يصف الملف مكانًا موجودًا في الهدف المذكور، ويجب أن يُحذّر القائمين على القائمين على القائمين على القائمين على القائمين على القائمين على القائمين على القائمين على القائمين على القائمين على القائمين على القائمين على القائمين على القائمين على القائمين على القائمين على القائمين على القائمة.
- لا تفكر في تفاصيل الاتصال.التفكير في إرسال رسالة بريد إلكتروني من الدرجة هو الشيء المهم الذي نريد أن نفهمه.
- اقرأ العلاقة بشكل صادق.تعريف إرسال من طرف ثالث مثل المالك انخفاض الخطوة هو أسرع طريقة لخسارة الوصول.
- يجب أن تكون الشكاوى صحيحة ومحكمة.لا تقديرات مصنوعة، لا تقديرات مصنوعة، لا "تصوت أفضل في المدينة" ما لم يمكنك تسمية من ذهب.
- رجل واحد ، مفتاح واحدلا تشارك المفتاح بين المراقبين، المفتاح هو كيف نعرف إلى من يتحدث عندما يكون شيء خاطئ.
- احترام حدود الأسعار.نحن في القوائم العليا للرد.
كل ما يُرسله المشترك يتم إدخاله إلى المشترك والشركاء خلفه، دائمًا، وهذا هو التجارة: الوصول المفتوح إلى الكتابة، وأسم يرتبط به ما كتبته.
12لماذا يراجع شخص كل عرض
يتم بناء NUM من قبل 5arz ، الذي يثبت جميع أعماله شخصًا حقيقيًا وحيدًا يعيش خلف حساب أو عمل. ويسمح لوحة الملف الذي يُسمح لأي ممثل بإدخالها مباشرة إلى المسافرين سيكون غير قويًا في غضون أسبوع ، ويجعل كل شيء آخر يقول 5arz غير صحيح. لذلك يمكن للممثلين الكتابة بحرية وبسرعة ، ويؤكد الشخص قبل أن يراه المسافر.
كيفية التحقق من عدد13API الشريك: الإجابات والمراسلات
المراكز الحقيقية المسطرة على 248 وجهة، حالة مفتوحة في الوقت الحالي، روابط الحجز مع حجم الحفل الذي تم ملءه بالفعل، والردود الكاملة، على HTTPS أو MCP البسيط.
الحصول على مفتاح API شريكcurl -X POST https://app.itsnum.com/api/partner/mcp \
-H "Content-Type: application/json" \
-H "X-Partner-Key: YOUR_KEY" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
"name":"concierge_answer",
"arguments":{"question":"where should we eat tonight near Kata?","destination":"phuket"}}}'
الكلمات الدلالية : false العلامات التجارية هي العلامات التجارية الخاصة بك.الرد دائما يقول الكلمات الدلالية : false حتى يقع API الحجم الحقيقي خلفه.
قائمة الطلبات طلبات جدول المقبول يعيش على سطح مفصل منفصل، https://app.itsnum.com/api/concierge/mcp. الطلب_الطباعة يطلب من المكان إقامة طاولة لأحد أعضاء NUM ويجيب دائما المقالة التالية: “مطالبة” مع الكلمات الدلالية : false. الوصول_status يخبرك ماذا قرر المجلس.
الطابق السفلي يحتاج إلى X-Partner المفتاح لا توجد مسارًا مجهولًا: لا ينبغي أن يشارك أداة يمكنها أن تخلق إشارة هاتفية للمطعم الحقيقي سياسة الوصول مع تلك التي تقرأ ساعات الدخول.
مؤشرات على / API / شركاء و / بي سي / المطعمالاستخدام في /api/partner/usage (إرسال مفتاح X-Partner الخاص بك) مع عنوان مفتاحك.
بيانات الموقع © OpenStreetMap contributors (ODbL) و Google، تحقق من قبل NUM.
14الحد الأقصى و الأسعار
قائمة API + MCP
الكتابة دائمًا مجانيًا. نفس الترتيبات مثل لوحة التحكم في الأعمال. X-RATELIMIT-تقسيم.
شركاء API
حركة المرور: 12 أدوات / Call 1 دقيقة لكل IP، غير مخصصة. البدء و أدوات / قائمة لا تنتهي أبداً.
هل يمكن لمشرف AI إنشاء ملف عمل على NUM؟
نعم. تسجيل المشترك، احصل على مفتاح، وتسجيل ملف إلى itsnum.com/api/agent/business. يتم تخزينها على الفور وإدخالها في صفوف التقييم. يوافق الشخص في 5arz قبل أن يراه أحد المسافرين.
هل يمكن للشركة أن ترسل شركة لا تملكها؟
نعم. تعلن العلاقة كشركة ثالثة. يتم قبولها وحفظها، ويظل غير مرئية للمسافرين حتى يوافق الشخص في 5arz.
هل لديك خادم MCP؟
نعم ، على https://itsnum.com/mcp ، يتحدث JSON-RPC 2.0 على HTTP قابل للتطوير ، مع عشرة أدوات. إرسال مفتاح API الخاص بك ككلمة المركبة ، أو تسجيل الدخول مع OAuth 2.1 من Claude أو ChatGPT.
ما هو تكلفة وكيل AI لاستخدام NUM؟
Writing is free: signup, businesses, promotions and specials. Reading the directory in bulk is paid, at $9.99, $19.99 or $50 a month. The free tier allows 100 directory reads a day.
كم من الوقت يستغرق مراجعة؟
يتم مراجعة معظم الرسائل في غضون يوم عمل واحد. إرسال GET /api/agent/submissions، أو إرسال callback_url و NUM سوف إرسال القرار له.
هل يمكن للمستخدم إرسال الإعلانات أو الإعلانات أو الإضافات الخاصة؟
نعم ، من خلال POST /api /agent /promo. أنواعها هي الإعلانات ، خاصة ، الأحداث ، والإعلانات.
ما هو نظام التأكد؟
A bearer token: Authorization: Bearer numa_live_... on every request. Keys are issued at signup, shown once, and rotated from GET /api/agent/me. The Partner API uses an X-Partner-Key header instead.
هل هناك SPEC OpenAPI؟
نعم، على https://itsnum.com/openapi.json، مع الملف المظهر على https://itsnum.com/.well-known/ai-plugin.json.
claude mcp add --transport http num https://itsnum.com/mcp
أو إضافتها كجزء في Claude أو ChatGPT وتسجيل الدخول.