लाइब्रेरी

list_photos

id, फ़ाइल नाम, पाथ, स्टेटस, स्कोर, विवरण और कैप्चर समय के साथ फ़ोटो की सूची पाएँ।

यह क्या करता है

name फ़ाइल नाम से फ़ोटो ढूँढता है, जैसे लोग उन्हें कहते हैं (“DSC04851”): केस-इनसेंसिटिव, नाम का हिस्सा मैच करता है, और कई अल्पविराम से अलग नाम एक साथ लेता है। यूज़र जो नाम बताता है उन्हें उन फ़ोटो id में बदलने के लिए इसका इस्तेमाल करें जो हर दूसरा टूल चाहता है। taken वह समय है जब फ़ोटो खींची गई (EXIF से ISO समय): विवरण न होने पर शूट को दिन या शाम के हिसाब से ग्रुप करने का तरीका (“सूर्यास्त वाले फ़्रेम”)। taken_after / taken_before इससे फ़िल्टर करते हैं (ISO, दोनों सिरे शामिल; सिर्फ़ तारीख पूरे दिन को कवर करती है), जैसे status="keep", taken_after="2026-09-22T18:00": बड़ी शूट पर सब कुछ सूचीबद्ध करने के बजाय फ़िल्टर करें। कैप्चर समय analyze_photos पढ़ता है, इसलिए समय से फ़िल्टर करने से पहले उसे चलाएँ; तब तक जवाब का नोट बताता है कि कितनी फ़ोटो का अभी समय नहीं है। स्टेटस (pending, keep, trash, culled, exported, error) से फ़िल्टर करें या सब कुछ के लिए उसे छोड़ दें। बड़ी लाइब्रेरी में पेज करने के लिए limit और offset का इस्तेमाल करें; जवाब में कुल मैच की गिनती होती है। इस सूची की फ़ोटो id वही हैं जो हर प्रति-फ़ोटो टूल चाहता है।

पैरामीटर

नामटाइपज़रूरी
status str | None वैकल्पिक
limit int वैकल्पिक
offset int वैकल्पिक
taken_after str | None वैकल्पिक
taken_before str | None वैकल्पिक
name str | None वैकल्पिक

इसे माँगना

आप इसे नाम से नहीं बुलाते। आप बताते हैं कि क्या चाहिए, और एजेंट टूल चुनता है:

D:/Shoots/eva_tom की शादी की शूट की फ़ोटो छाँटिए, सबसे अच्छे फ़्रेम रखिए, और बताइए कि आपने क्या हटाया।

लाइब्रेरी के बाक़ी टूल

scan_directory get_library_stats get_photo get_preview_url get_job_status

इसे इस्तेमाल करने वाले वर्कफ़्लो

यह कहाँ चलता है

आपकी मशीन पर। imagic का MCP सर्वर एक लोकल प्रोसेस है जिसे आपका AI क्लाइंट शुरू करता है; फ़ोटो कभी आपकी डिस्क से बाहर नहीं जातीं और कुछ अपलोड नहीं होता। यह रेफ़रेंस के हर टूल पर लागू है, इस पर भी।

इसे चलाने के लिए आपको imagic से जुड़ा एक MCP क्लाइंट चाहिए। Claude Code, Cursor, VS Code, Codex, Gemini CLI और दस अन्य के लिए सेटअप में लगभग तीन मिनट लगते हैं।

अपने AI को पूरी पाइपलाइन दें

list_photos imagic Max के 30 टूल में से एक है। 500 एक्सपोर्ट के मुफ़्त ट्रायल में वे सभी शामिल हैं।