उदाहरण द्वारा आदेश
हर fastsite कमांड, उस सरल वाक्य के साथ जो उसे ट्रिगर करता है — ताकि आप पहचान सकें कि आपके एजेंट ने अभी क्या किया, और जब ज़रूरत हो तो सटीक रह सकें।
आप fastsite पर कमांड के नाम नहीं टाइप करते। आप बताते हैं कि आप क्या चाहते हैं और एजेंट टूल चुन लेता है। फिर भी नाम यहाँ दो कारणों से हैं: ताकि आप पहचान सकें कि आपके एजेंट ने आपकी साइट के साथ अभी क्या किया, और ताकि जहाँ ज़रूरी हो वहाँ आप सटीक हो सकें। अगर अभी तक कोई क्लाइंट कनेक्ट नहीं है, तो पहले अपना एजेंट कनेक्ट करें और फिर वापस आएं।
दो शुरुआती कमांड
नाम से जानने योग्य दो कमांड हैं, क्योंकि हर सेशन इन्हीं से शुरू होता है।
| मेरी साइटें दिखाओ। | list_sites — हैंडल लौटाता है। साइट हैंडल लगभग हर दूसरे कमांड का पहला तर्क होता है, इसलिए इससे सेशन को दिशा मिलती है। |
| साइट blog के लिए ऑथरिंग गाइड पढ़ो, फिर पेज का ड्राफ्ट बनाओ। | get_authoring_guide — वे नियम जो बिल्ड ऑडिट वास्तव में लागू करता है, उस साइट के लोकेल और एम्बेड सिंटैक्स के साथ मिलाकर। जो एजेंट इसे पढ़ता है वह ऐसा मार्कअप लिखता है जो पब्लिश होता है। जो अनुमान लगाता है वह ऐसा मार्कअप लिखता है जो अस्वीकार हो जाता है। |
आपके पहले दस मिनट
खाली इंजन से पब्लिश पेज तक। इन्हें एक-एक करके कहें और आगे बढ़ने से पहले जो वापस आए उसे पढ़ें।
- notes.example.com पर Notes नाम की एक साइट बनाओ।
create_site आपको एक हैंडल देता है जिससे बाकी सब कुछ संबोधित किया जाता है। - उस साइट के लिए ऑथरिंग गाइड पढ़ो।
get_authoring_guide। कोई भी लेखन या डिज़ाइन से पहले यह करें, पहली अस्वीकृति के बाद नहीं। - शेल फाइलें दिखाओ।
shell_list_files — Twig टेम्पलेट और CSS टोकन जो हर पेज को लपेटते हैं। - शेल का स्नैपशॉट लो, फिर हेडर को गहरा करो।
shell_snapshot, फिर shell_put_file। स्नैपशॉट सस्ते हैं और एक को रिस्टोर करना एक ही कमांड में होता है। - एक छोटा about पेज लिखो।
create_page। यह ड्राफ्ट के रूप में आता है। - साइट का प्रीव्यू देखो।
preview_site बिना डिप्लॉय किए बिल्ड करता है और एक URL वापस देता है। बिल्ड ऑडिट यहाँ चलता है, इसलिए यहीं खराब मार्कअप सामने आता है। - पब्लिश करो।
publish_site। एक git कमिट, CDN के पीछे लाइव।
CDN तक कुछ भी अपने आप नहीं पहुँचता
लिखना, संपादन, अनुवाद और रीडिज़ाइन सब इंजन के अंदर ही रहते हैं। पब्लिक साइट तब बदलती है जब आप publish कहते हैं, और वह एक ही कमिट है जिसे आप रिवर्ट कर सकते हैं। इसके बजाय प्रीव्यू माँगें और आपको एक ऐसा बिल्ड मिलता है जिसे कोई और नहीं देख रहा।
सामग्री
| ब्लॉग पर मेरे पास क्या है? | list_posts |
| पोस्ट 14 दिखाओ। | get_post — बॉडी HTML सहित, जो आपको किसी संपादन के लिए कहने से पहले चाहिए। |
| रिलीज़ के बारे में एक पोस्ट लिखो, इसे पब्लिश करो। | create_post |
| एक pricing पेज जोड़ो। | create_page — बिना तारीख के वही चीज़। स्लग नेस्टेड हो सकते हैं, इसलिए help/getting-started काम करता है अगर आप पुरानी URL संरचना बनाए रख रहे हैं। |
| उस पोस्ट का दूसरा हिस्सा कसो और हेडिंग ठीक करो। | update_post — केवल वही फ़ील्ड बदलते हैं जो वह भेजता है। |
| पुराना लॉन्च पेज हटाओ। | delete_content — ट्रैश में, गया नहीं। अगला बिल्ड पेज हटा देता है। |
शोध और जाँच
दोनों वेब-आधारित मॉडल को कॉल करते हैं, इसलिए इनमें एक पल लगता है और जिसमें कोई संख्या हो उस पर ये सार्थक हैं।
| लिखने से पहले शोध करो कि इस साल EU एक्सेसिबिलिटी नियमों में क्या बदला। | research — आँकड़ों और स्रोतों के साथ एक संरचित संक्षिप्त विवरण, जिससे लिखा जाए। पहले स्रोत, फिर ड्राफ्ट। |
| उस पोस्ट की तथ्य-जाँच करो। | fact_check — स्रोतों के साथ प्रति-दावा निर्णय, कंटेंट रो पर रखे जाते हैं। कीमतें और आँकड़े इसी के लिए हैं। प्रति साइट सक्षम करें। |
मीडिया
| वह इमेज इम्पोर्ट करो और इसे फीचर्ड इमेज के रूप में उपयोग करो। | upload_media_from_url। अपलोड के समय alt टेक्स्ट आवश्यक है, और इमेज मीडिया id द्वारा एम्बेड की जाती हैं — बॉडी में बाहरी इमेज URL बिल्ड फेल करता है। |
| मीडिया लाइब्रेरी में क्या है? | list_media |
| पुराना स्क्रीनशॉट हटाओ। | delete_media, restore_media से पूर्ववत किया जा सकता है। purge_media वह है जो फाइलें हमेशा के लिए हटाता है। |
डिज़ाइन
शेल हर पेज के चारों ओर का ढाँचा है: Twig टेम्पलेट, CSS टोकन, अनुवाद स्ट्रिंग। कंटेंट अपनी स्टाइलिंग कभी नहीं रखता, इसलिए रीडिज़ाइन यहीं होता है।
| शेल में क्या है? | shell_list_files |
| बेस टेम्पलेट दिखाओ। | shell_get_file |
| पूरी साइट में एक्सेंट रंग को गर्म बनाओ। | टोकन फाइल पर shell_put_file — आमतौर पर एक-लाइन का संपादन जो सब कुछ रंग देता है। लिखने पर मान्य, रीबिल्ड ट्रिगर करता है। |
| पहले शेल का स्नैपशॉट लो। | shell_snapshot |
| इसे पहले जैसा करो। | shell_restore — और रिस्टोर पहले अपना स्नैपशॉट लेता है, इसलिए अनडू का अनडू काम करता है। |
कॉम्पोनेंट
| मेरे लिए एक pricing टेबल कॉम्पोनेंट बनाओ। | upsert_component — HTML या React। बिल्ड इसे स्टैटिक मार्कअप में रेंडर करता है, इसलिए कुछ भी JavaScript के रूप में नहीं जाता। |
| इस साइट में कौन से कॉम्पोनेंट हैं? | list_components, और एक हटाने के लिए delete_component। |
भाषाएँ
| जर्मन जोड़ो और सब कुछ अनुवाद करो। | add_language — लोकेल जोड़ता है और अनुवाद की कतार लगाता है। |
| अनुवाद रीफ्रेश करो, मैंने तीन पेज बदले। | translate_site, जो पूरा होने पर पब्लिश करता है। |
| हेडर में एक भाषा स्विचर लगाओ। | get_language_switcher मार्कर और मार्कअप लौटाता है। प्लेसमेंट आपकी ज़िम्मेदारी है — कुछ भी स्वचालित रूप से नहीं जोड़ा जाता। |
| Swedish हटाओ। | remove_language — अनुवाद और लोकेल के पेज हटाता है, फिर रीबिल्ड करता है। |
पब्लिशिंग
| इसका प्रीव्यू देखो। | preview_site — बिल्ड करता है, ऑडिट चलाता है, कुछ डिप्लॉय नहीं करता। |
| पब्लिश करो। | publish_site — देखने के लिए एक जॉब लौटाता है। |
| हो गया? | get_build_status |
| हाल ही में क्या बिल्ड हुआ? | list_jobs — बिल्ड, पब्लिश और अनुवाद, नवीनतम पहले। |
रूटिंग और साइट स्क्रिप्ट
| पुराने pricing URL को नए पर पॉइंट करो। | upsert_redirect। list_redirects कैप्चर किए गए 404 भी दिखाता है, जो शुरू करने की बेहतर जगह है। |
| वह रीडायरेक्ट हटाओ। | delete_redirect |
| analytics स्निपेट जोड़ो। | upsert_script — head या body, साइट स्तर पर सेट, न कि बॉडी में पेस्ट। बाकी के लिए list_scripts और delete_script। |
स्क्रिप्ट वह एकमात्र चीज़ है जो आपका स्कोर खर्च करती है
इंजन में बाकी सब कुछ एक पेज को सभी क्षेत्रों में 100 पर रखने के लिए बनाया गया है। हेडर या फुटर स्क्रिप्ट सक्षम करें और साइट उस गारंटी से बाहर हो जाती है — यह आपका निर्णय है, लेकिन इसे आदत से टैग पेस्ट करने की बजाय जानबूझकर करें।
चीज़ें पूर्ववत करना
तीन अलग सुरक्षा जाल, तीन अलग आकारों में।
| ट्रैश में क्या है? | list_trash, फिर restore_content। purge_content स्थायी वाला है। |
| शेल को कल के रिविज़न पर रिस्टोर करो। | shell_restore — केवल डिज़ाइन, कोई कंटेंट नहीं छुआ जाता। |
| साइट का बैकअप लो। | backup_site, list_backups, restore_backup — डेटाबेस सहित पूरी साइट। रिस्टोर रीबिल्ड और पब्लिश करता है। |
साइटें, टीमें और क्रेडेंशियल
| नए क्लाइंट के लिए एक साइट बनाओ। | create_site |
| बेस URL और git ब्रांच बदलो। | update_site — यहीं serve mode, canonical host और fact-check टॉगल भी रहते हैं। |
| अपना GitHub टोकन जोड़ो ताकि यह पब्लिश कर सके। | add_github_credential, साथ में list_github_credentials और delete_github_credential। टोकन एन्क्रिप्टेड संग्रहीत होते हैं और कभी वापस नहीं किए जाते। |
| अपने डिज़ाइनर को आमंत्रित करो। | create_team, invite_member, accept_invite, list_teams। |
वेबहुक
| इस साइट में क्या पोस्ट कर सकता है? | list_webhooks — बिल्ट-इन मैपर भी सूचीबद्ध करता है, जो इनबाउंड पेलोड को पोस्ट या पेज में बदलते हैं। |
| मुझे एक एंडपॉइंट दो जिस पर मेरा ऑटोमेशन ड्राफ्ट पोस्ट कर सके। | create_webhook |
| क्या वह फायर हुआ? | webhook_deliveries |
पूरी यांत्रिकी webhooks पेज पर है।
जब कोई कमांड एरर के साथ वापस आए
विफलताएँ ट्रांसपोर्ट एरर की बजाय पठनीय संदेशों के रूप में वापस आती हैं, जिसका मतलब है कि आपका एजेंट आमतौर पर संदेश पढ़ सकता है और खुद को सुधार सकता है। उसे कहें। तीन जो आप पहले मिलेंगे:
- बॉडी अस्वीकार कर दी गई। कंटेंट केवल बॉडी HTML है — कोई
<script> नहीं, कोई इनलाइन स्टाइल नहीं, कोई बाहरी इमेज नहीं। एजेंट से ऑथरिंग गाइड पढ़ने और दोबारा लिखने के लिए कहें। - एक इमेज ने बिल्ड फेल किया। इमेज पहले अपलोड होनी चाहिए और alt टेक्स्ट के साथ मीडिया id द्वारा संदर्भित होनी चाहिए। हॉटलिंक्ड URL कभी पास नहीं होता।
- लाइव साइट पर कुछ नहीं बदला। लिखना पब्लिशिंग नहीं है।
publish_site के लिए कहें, या अगर आप पहले ही कर चुके हैं तो get_build_status जाँचें।
नीचे का प्रोटोकॉल — डिस्कवरी, स्कोप, टोकन लाइफटाइम, आपके वर्शन के लिए आधिकारिक टूल कैटलॉग — MCP संदर्भ पर है। सादा HTTP पसंद करते हैं? REST API API key के साथ वही कवर करता है।